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为 什么 写 这 本 书 


2007 年 的 时 候 ， 我 加 入 了 一 个 新 成 立 的 开 及 团队 ， 我 们 一 起 做 一 个 
新 的 项 目 。 经 验 较 丰富 的 同事 习惯 性 地 开始 编写 Ant 脚 本 ， 也 有 人 和 希望 
能 尝试 一 人 Maven。 当 时 我 比较 年 轻 ， 且 主 有 激情 ， 因 此 大 家 决定 让 我 
对 Maven 做 些 研究 和 实践 。 于 是 我 慢 慢 开始 学 习 并 推广 Maven， 这 期 间 
有 人 支持 ， 也 有 人 抵触 ， 而 我 则 尽力 地 为 大 家 排除 困难 ， 并 做 一 些 内 部 
交流 ， 渐 渐 地 ， 抵 触 的 人 越 来 越 少 ， 我 的 工作 也 得 到 了 大 家 的 认可 。 








为 什么 一 开始 有 人 会 抵触 这 一 优秀 的 技术 呢 ? 后 来 我 开始 反思 这 一 
经 历 ， 我 认为 Maven 陡 峭 的 学 习 曲 线 和 匮乏 的 文档 是 当时 最 主要 的 问 
题 。 为 了 能 改善 这 个 问题 ， 我 开始 在 博客 中 撰写 各 类 关于 Maven 的 中 文 
博客 ， 翻 译 了 O"Reilly 出 版 的 《Maven 权 威 指南 》 一 书 ， 并 建立 了 国内 
的 Maven 中 文 社区 ， 不 定期 地 回答 各 类 Maven 相 关 问 题 ， 这 在 一 定 程度 
上 推动 了 Maven 这 一 优秀 的 技术 在 国内 的 传播 。 





后 来 我 加 入 了 Maven 之 父 Jason Van Zyl 创建 的 Sonatype， 参 与 Nexus 
的 开发 并 负责 维护 Maven 中 央 仓库 ， 这 些 工作 使 我 对 开源 和 Maven 有 了 
更 深 的 认识 ， 也 给 了 我 从 头 写 一 本 关于 Maven 的 书 的 信心 。 我 希望 它 能 
够 更 贴近 国内 的 技术 人 员 的 需求 ， 能 够 出 现在 书店 的 某 个 角落 里 ， 给 那 


些 有 心 发 现 它 的 读者 融 来 一 丝 欣 喜 。 


该 书写 作 后 期 适 逢 Maven 3 的 发 布 ， 这 距离 我 刚 接触 Maven 时 已 经 
过 去 3 年 有 余 ， 感 叹 时 光 的 流逝 ! Maven 在 2007 年 至 2010 年 取得 了 飞速 
的 发 展 ， 现 在 几乎 已 经 成 为 了 所 有 Java 开 源 项 目的 标 配 ，Struts、 
Hibernate、Ehcache 等 知名 的 开源 项 目 都 使 用 Maven 进 行 管理 。 据 了 解 ， 
国内 也 有 越 来 越 多 的 知名 的 软件 公司 开始 使 用 Maven 管 理 他 们 的 项 目 ， 
例如 阿里 巴巴 和 淘宝 。 





本 书面 向 的 读者 


首先 ， 本 书 适合 所 有 Java 程 序 员 阅 读 。 由 于 自动 化 构建 、 依 赖 管理 
等 问题 并 不 只 存在 于 Java 世 界 ， 因 此 非 Java 程 序 员 也 能 够 从 该 书 中 获 
益 。 无 论 你 是 从 未 接触 过 Maven、 还 是 已 经 用 了 Maven 很 长 时 间 ， 亦 或 
想 要 扩展 Maven， 都 能 从 本 书 获得 有 价值 的 参考 建议 。 





im. 


ihe 


其 次 ， 本 书 也 适合 项 目 经 理 阅 读 ， 它 能 帮助 你 更 规范 、 更 高 效 地 管 


理 Java 项 目 。 


本 书 的 主要 内 容 


第 1 章 对 Maven 做 了 简要 介绍 ， 通 过 一 些 程序 员 熟 悉 的 例子 介绍 了 
Maven 是 什么 ， 为 什么 需要 Maven。 建 议 所 有 读者 都 阅读 以 获得 一 个 大 
局 的 印象 。 


些 内 容 对 初学 者 很 有 帮 





第 2~3 章 是 对 Maven 的 一 个 入 门 介绍 ， 


助 ， 如 果 你 已 经 比较 熟悉 Maven， 可 以 跳 过 。 











第 4 章 介 绍 了 本 书 使 用 的 背景 案例 ， 后 面 的 很 多 章节 都 会 基于 该 案 
例 展开 ， 因 此 建议 读者 至 少 简单 浏览 一 过 。 





第 5~8 章 深入 前 述 了 Maven 的 核心 概念 ， 包 括 坐 标 、 人 依赖、 仓库 、 
生命 周期 、 插 件 、 继 承 和 多 模块 聚合 ， 等 等 ， 每 个 知识 点 都 有 实际 的 案 
例 相 佐 ， 建 议 读者 仔细 阅读 。 


第 9 章 介 绍 使 用 Nexus 建 立 私 服 ， 如 果 你 要 在 实际 工作 中 使 用 


Maven， 这 是 必 不 可 少 的 。 


第 10~16 章 介绍 了 一 些 相 对 高 级 且 离 散 的 知识 点 ， 包 括 测 试 、 持 续 
集成 与 Hudson、Web 项 目 与 自动 化 部 署 、 自 动 化 版 本 管理 、 智 能 适应 环 
境 差 异 的 灵活 构建 、 站 点 生成 ， 以 及 Maven 的 Eclipse 插件 m2eclipse， 等 
等 。 读 者 可 以 根据 自己 实际 需要 和 兴趣 选择 性 地 阅读 。 














第 17~18 章 介绍 了 如 何 编写 Archeype 和 Maven 插 件 。 一 般 的 Maven 用 
户 在 实际 工作 中 往往 不 需要 接触 这 些 知 识 ， 如 果 你 需要 编写 插件 扩展 
Maven， 或 者 需要 编写 Archetype 维 护 自 己 的 项 目 骨架 以 方便 团队 开发 ， 
那么 可 以 仔细 阅读 这 两 章 的 内 容 。 





咖啡 与 工具 


本 书 相 当 一 部 分 的 内 容 是 在 苏州 十 全 街 边 的 Solo 咖 啡 第 完成 的 ， 老 
板 Yin 杀 手 烘 焙 咖啡 豆 、 并 能 做 出 据说 是 苏州 最 好 的 咖啡 ， 这 人 小 桥 流 水 
上 昱 的 温 世 小 屋 能 够 帮 我 消除 紧张 和 焦虑 ， 和 Yin 有 一 人 句 没 一 句 的 聊天 也 
古 相 当 的 轻松 。Yin 还 教会 了 我 如 何 自己 研磨 咖啡 豆 、 手 冲 涌 率 咖啡 ， 
让 我 能 够 每 天 在 家 里 也 能 享受 香气 四 淳 的 新 鲜 咖 啡 。 











Ax. Fees 


本 书 的 书稿 是 使 用 Git 和 Unfuddle Chttp://unfuddle.com/) 进行 管理 
的 ， 书 中 的 大 量 截 图 是 通过 Jing Chttp://www.techsmith.com/jing/) 制作 
的 。 
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第 1 章 ”Maven 简 介 


何 为 Maven 

.为 什么 需要 Maven 
-Maven 与 极限 编程 
被 误解 的 Maven 


小 结 


1.1 何 为 Maven 


Maven 这 个 词 可 以 翻译 为 “知识 的 积累 ?”， 也 可 以 翻译 为 “专家 ”或 “内 
。 本 书 将 介绍 Maven 这 一 路 平台 的 项 目 管 理工 具 。 作 为 Apache 组 织 
中 的 一 个 颇 为 成 功 的 开源 项 目 ，Maven 主 要 服务 于 基于 Java 平 台 的 项 目 
构建 、 依 赖 管理 和 项 目 信 息 管理 。 无 论 是 小 型 的 开源 类 库 项 目 ， 还 是 大 
型 的 企业 级 应 用 ; 无 论 是 传统 的 瀑布 式 开发 ， 还 是 流行 的 敏捷 模式 ， 
Maven 都 能 大 显 身手 。 














1.1.1 何 为 构建 








不 管 你 是 否 意识 到 ， 构 建 build) 是 每 一 位 程序 员 每 天 都 在 做 的 工 
作 。 早 上 来 到 公司 ， 我 们 做 的 第 一 件 事情 束 是 从 源码 库 签 出 最 新 的 源 
码 ， 然 后 进行 单元 测试 ， 如 果 友 现 失 败 的 测试 ， 会 找 相关 的 同事 一 起 调 
试 ， 修 复 错误 代码 。 接 着 回 到 上 自己 的 工作 上 来 ， 编 写 自己 的 单元 测试 及 
产品 代码 ， 我 们 会 感激 IDE 随 时 报 出 的 编译 错误 提示 。 








忙 到 午饭 时 间 ， 代 码 编写 得 差不多 了 ， 测 试 也 通过 了 ， 开 心地 享用 
午餐 ， 然 后 休息 。 下 午 先 在 昏 昏 沉沉 中 开 了 个 例会 ， 会 议 结束 后 喝 杯 咖 
啡 继续 工作 。 刚 才 在 会 上 经 理 要 求 看 测试 报告 ， 于 是 找 了 相关 工具 集成 
进 IDE， 生 成 了 像 模 像样 的 测试 履 闵 率 报告 ， 接 着 发 了 一 封 电子 邮件 给 
经 理 ， 松 了 口气 。 谁 料 QA 小 组 又 发 过 来 了 几 个 bug， 没 办 法 ， 先 本 地 重 
现 再 说 ， 于 是 熟练 地 用 IDE 生 成 了 一 个 WAR 包 ， 部 署 到 Web 容 絮 下 ， 启 
动容 器 。 看 到 熟悉 的 界面 了 ， 遵 循 bug 报 告 ， 一 步 步 重 现 了 bug..…... 快 下 
班 的 时 候 ，bug 修 好 了 ， 提 交代 码 ， 通 知 QA 小 组 ， 在 愉快 中 结束 了 一 天 
的 工作 ， 








仔细 总 结 一 下 ， 我 们 会 发 现 ， 除 了 编写 源 代码 ， 我 们 每 天 有 相当 一 
部 分 时 间 花 在 了 编译 、 运 行 单 元 测试 、 生 成 文档 、 打 包 和 部 普 等 烦 珊 且 
不 起 眼 的 工作 上 ， 这 惑 是 构建 。 如 采 我 们 现在 还 手工 这 样 做 ， 那 成 本 也 








太 高 了 ， 于 是 有 人 用 软件 的 方法 让 这 一 系列 工作 完全 上 自动化， 使 得 软件 
的 构建 可 以 像 全 目 动 流水 线 一 样 ， 只 需要 一 条 简单 的 命令 ， 所 有 烦琐 的 
步 又 都 能 够 目 动 完成 ， 很 快 束 能 得 到 最 终结 果 。 








1.1.2 ”Maven 是 优秀 的 构建 工具 


前 面 介绍 了 Maven 的 用 途 之 一 是 服务 于 构建 ， 它 是 一 个 异常 强大 的 
构建 工具 ， 能 够 帮 我 们 自动 化 构建 过 程 ， 从 清理 、 编 译 、 测 试 到 生成 报 
告 ， 再 到 打包 和 部 署 。 我 们 不 需要 也 不 应 该 一 遍 又 一 遍地 输入 命令 ， 一 
次 又 一 次 地 点 击 鼠 标 ， 我 们 要 做 的 是 使 用 Maven 配 置 好 项 目 ， 然 后 输入 
简单 的 命令 (如 mvn clean install) ，Maven 会 帮 我 们 处 理 那些 烦琐 的 任 
务 。 





Maven 是 跨 平 台 的 ， 这 意味 着 无 论 是 在 Windows 上， 还 是 在 Linux 或 


者 Mac 上 ， 都 可 以 使 用 同样 的 命令 。 


我 们 一 直 在 不 停 地 寻找 避免 重复 的 方法 。 设 计 的 重复 、 编 码 的 重 
复 、 文 档 的 重复 ， 当 然 还 有 构建 的 重复 。Maven 最 大 化 地 消除 了 构建 的 
重复 ， 抽 象 了 构建 生命 周期 ， 并 且 为 绝 大 部 分 的 构建 任务 提供 了 已 实现 
的 插件 ， 我 们 不 再 需要 定义 过 程 ， 甚 到 不 需要 再 去 实现 这 些 过 程 中 的 一 
些 任务 。 最 简单 的 例子 是 测试 ， 我 们 没 必要 告诉 Maven 去 测试 ， 更 不 需 
要 告诉 Maven 如 何 运行 测试 ， 只 需要 遵循 Maven 的 约定 编写 好 训 试 用 
例 ， 当 我 们 运行 构建 的 时 候 ， 这 些 测试 便 会 自动 运行 。 





想象 一 下 ，Maven 抽 象 了 一 个 完整 的 构建 生命 周期 模型 ， 这 个 模型 
吸取 了 大 量 其 他 的 构建 脚本 和 构建 工具 的 优点 ， 总 结 了 大 量 项 目的 实际 








需求 。 如 果 亲 循 这 个 模型 ， 可 以 避免 很 多 不 必要 的 错误 ， 可 以 直接 使 用 
大 量 成 熟 的 Maven 插 件 来 完成 我 们 的 任务 《很 多 时 候 我 们 可 能 都 不 知道 
目 己 在 使 用 Maven 插 件 ) 。 此 外 ， 如 果 有 非常 特殊 的 需求 ， 我 们 也 可 以 
轻松 实现 目 己 的 插件 。 


Maven 还 有 一 个 优点 ， 它 能 帮助 我 们 标准 化 构建 过 程 。 在 Maven 之 
前 ， 十 个 项 目 可 能 有 十 种 构建 方式 ; 有 了 Maven 之 后 ， 所 有 项 目的 构建 
命令 者 是 简单 一 致 的 ， 这 极 大 地 避免 了 不 必要 的 学 习 成 本 ， 而 且 有 利于 
促进 项 目 团队 的 标准 化 。 


综 上 所 述 ，Maven 作 为 一 个 构建 工具 ， 不 仅 能 帮 我 们 上 自动 化 构建 ， 
还 能 够 抽象 构建 过 程 ， 提 供 构 建 任务 实现 ， 它 跨 平台 ， 对 外 提供 了 一 致 
的 操作 接口 ， 这 一 切 足 以 使 它 成 为 优秀 的 、 流 行 的 构建 工具 。 


1.1.3 “Maven 不 仅仅 是 构建 工具 





Java 不 仅 是 一 门 编程 语言 ， 还 是 一 个 平台 ， 通 
们 可 以 在 Java 平 台 上 编写 和 运行 Ruby 和 Python 程序 。 我 们 也 应 该 认识 
到 ，Maven 不 仅 是 构建 工具 ， 还 是 一 个 依赖 管理 工具 和 项 目 信息 管理 工 
有 具 。 它 提供 了 中 央 仓库 ， 能 帮 我 们 自动 下 载 构 件 。 


过 JRuby 和 Jython， 我 





在 这 个 开源 的 年 代 里 ， 几 乎 任何 Java 应 用 都 会 借用 一 些 第 三 方 的 开 
源 类 库 ， 这 些 类 库 都 可 通过 依赖 的 方式 引入 到 项 目 中 来 。 随 着 依赖 的 增 
多 ， 版 本 不 一 致 、 版 本 冲突 、 依 赖 胱 肿 等 问题 都会 接 中 而 来 。 手 工 解决 
这 些 问题 是 十 分 枯燥 的 ， 幸 运 的 是 Maven 提 供 了 一 个 优秀 的 解决 方案 ， 
它 通 过 一 个 坐标 系统 准确 地 定位 每 一 个 构件 Cartifact) ， 也 就 是 通过 一 
组 坐标 Maven 能 够 找到 任何 一 个 Java 类 库 〈( 如 jar 文 件 ) 。Maven 给 这 个 
类 库 世 界 引 入 了 经 纬 ， 让 它们 变 得 有 秩序 ， 于 是 我 们 可 以 借助 它 来 有 序 
地 管理 依赖 ， 轻 松 地 解决 那些 壹 杂 的 依赖 问题 。 


Maven 还 能 帮助 我 们 管理 原本 分 散在 项 目 中 各 个 角落 的 项 目 信息 ， 
包括 项 目 描述 、 开 发 者 列表 、 版 本 控制 系统 地 址 、 许 可 证 、 缺 陷 管 理 系 
统 地 址 等 。 这 些微 小 的 变化 看 起 来 很 琐碎 ， 并 不 起 眼 ， 但 却 在 不 知 不 党 
中 为 我 们 市 省 了 大 量 寻 找 信息 的 时 间 。 除 了 直接 的 项 目 信 息 ， 通 过 
Maven 自 动 生 成 的 站 点 ， 以 及 一 些 已 有 的 插件 ， 我 们 还 能 够 轻松 获得 项 








目 文档 、 测 试 报告 、 静 态 分 析 报告 、 源 码 版 本 日 志 报告 等 非常 具有 价值 
的 项 目 信息 。 





Maven 还 为 全 世界 的 Java 开 发 者 提供 了 一 个 免费 的 中 央 仓 库 ， 在 其 
中 几乎 可 以 找到 任何 的 流行 开源 类 库 。 通 过 一 些 Maven 的 衍生 工具 (如 
Nexus) ， 我 们 还 能 对 其 进行 快速 地 搜索 。 只 要 定位 了 坐标 ，Maven 就 
Hels RIA RRM, BA SFL). 


使 用 Maven 还 能 享受 一 个 额外 的 好 处 ， 即 Maven 对 于 项 目 目录 结 
构 、 测 试用 例 命 名 方式 等 内 容 都 有 既定 的 规则 ， 只 要 遵循 了 这 些 成 熟 的 
规则 ， 用 户 在 项 目 间 切 换 的 时 候 就 免 去 了 额外 的 学 习 成 本 ， 可 以 说 是 约 
定 优 于 配置 (Convention Over Configuration) 。 


1.2 ”为 什么 需要 Maven 


Maven 不 是 Java 领 域 唯一 的 构建 管理 的 解决 方案 。 本 节 将 通过 一 些 
简单 的 例子 解释 Maven 的 必要 性 ， 并 介绍 其 他 构建 解决 方案 ， 如 IDE、 
Make 和 Ant， 并 将 它们 与 Maven 进 行 比 较 。 


1.2.1 组 装 PC 和 品牌 PC 


笔者 初中 时 开始 接触 计算 机 ， 到 了 口中 时 更 是 梦 续 以 求 布 望 拥有 一 
台 目 己 的 计算 机 。 我 的 第 一 合计 算 机 是 赛 扬 733 的 ， 选 购 是 一 个 漫长 的 
过 程 ， 我 先 阅 读 了 大 量 的 杂志 以 了 解 各 类 配件 的 优 务 ，CPU、 内 存 、 主 
板 、 显 卡 ， 甚 至 声卡 ， 我 都 仔细 地 挑选 ， 后 来 还 跑 了 很 多 了 商家 ， 调 货 、 
讨价还价 ， 组 装 好 后 自己 闭 操 作 系 统 和 驱动 程序 .…… 虽 然 这 花费 了 我 大 
量 时 间 ， 但 我 很 孚 受 这 个 过 程 。 可 是 事实 证 明 ， 闭 出 来 的 机 器 稳定 性 不 


怎么 好 。 























一 年 前 我 需要 配 一 台 工 作 站 ， 这 时 候 我 已 经 没有 太 多 时 间 去 研究 电 
脑 配件 了 。 我 选择 了 某 知 名 PC 供应 丙 的 在 线 商 店 ， 大 概 浏览 了 一 下 主 
流 的 机 型 ， 选 择 了 我 需要 的 配置 ， 然 后 下 单 、 付 球 。 接 着 PC 供应 两 帮 
我 组 装 电 脑 、 安 装 操 作 系 统 和 驱动 程序 。 一 周 后 ， 物 流 公 司 将 电脑 送 到 
我 的 家 里 ， 我 接 上 显示 器 、 电 源 、 鼠 标 和 键盘 就 能 直接 使 用 了 。 这 为 我 
节省 了 大 量 时 间 ， 而 且 这 人 台电 脑 十 分 稳定 ， 丙 家 在 把 电脑 发 送 给 我 之 前 
己 经 进行 了 很 好 的 测试 。 对 了 ， 我 还 能 孚 受 两 年 的 售后 服务 。 




















使 用 脚本 建立 高 度 目 定义 的 构建 系统 束 像 买 组 装 PC， 耗 时 费力 ， 
结果 也 不 一 定 很 好 。 当 然 ， 你 可 以 圣 受 从 无 到 有 的 乐趣 ， 但 鸭 怕 实际 项 
目 中 无 法 给 你 那么 多 时 间 。 使 用 Maven 就 像 购买 品牌 PC， 省 时 省 力 ， 并 


能 得 到 成 熟 的 构建 系统 ， 还 能 得 到 来 自 于 Maven 社 区 的 大 量 文 持 。 唯 一 
与 购买 品牌 PC 不 同 的 是 ，Maven 是 开源 的 ， 你 无 须 为 此 付费 。 如 果 有 兴 
趣 ， 你 还 能 去 了 解 Maven 是 如 何 工作 的 ， 而 我 们 无 法 知道 那些 PC 巨头 的 
商业 秘密 。 


1.2.2 IDE 不 是 万 能 的 





当然 ， 我 们 无 法 否认 优秀 的 IDE 能 大 大 提高 开发 效率 。 当 前 主流 的 
IDE 如 Eclipse 和 NetBeans 等 都 提供 了 强大 的 文本 编辑 、 调 试 甚至 重 构 功 
能 。 虽 然 使 用 简单 的 文本 编辑 器 和 命令 行 也 能 完成 绝 大 部 分 开发 工作 ， 
但 很 少 有 人 愿意 那样 做 。 然 而 ，IDE 是 有 其 天 生 缺 陷 的 : 


IDE 依 赖 大 量 的 手工 操作 。 编 译 、 测 试 、 代 码 生 成 等 工作 都 是 相互 
独立 的 ， 很 难 一 键 完成 所 有 工作 。 手 工 劳 动 往往 意味 着 低 效 ， 意 味 着 容 
易 出 错 。 





.很 难 在 项 目 中 统一 所 有 的 IDE 配 置 ， 每 个 人 都 有 自己 的 喜好 。 也 正 
是 由 于 这 个 原因 ， 一 个 在 机 器 A 上 可 以 成 功 运行 的 任务 ， 到 了 机 器 B 的 
IDE 中 可 能 就 会 失败 。 





我 们 应 该 合理 利用 IDE， 而 不 是 过 多 地 依赖 它 。 对 于 构建 这 样 的 任 
务 ， 在 IDE 中 一 次 次 地 点 击 鼠 标 是 患 一 的 行为 。Maven 古 这 方面 的 专 
家 ， 而 且 主 流 IDE 都 集成 了 Maven， 我 们 可 以 在 IDE 中 方便 地 运行 Maven 
执行 构建 。 





1.2.3 Make 





Make 也 许 是 最 早 的 构建 工具 ， 它 由 Stuart Feldman 于 1977 年 在 Bell 实 
验 室 创建 。Stuart Fealdman 也 因此 于 2003 年 获得 了 ACM 国 际 计 算 机 组 织 
颁发 的 软件 系统 奖 。 目 前 Make 有 很 多 衍生 实现 ， 包 括 最 流行 的 GNU 
Make 和 BSD Make， 还 有 Windows 平 台 的 Microsoft nmake 等 。 


Make 由 一 个 名 为 Makefile 的 脚本 文件 驱动 ， 该 文件 使 用 Make 自 己 定 
义 的 语法 格式 。 其 基本 组 成 部 分 为 一 系列 规则 (Rules) ， 而 每 一 条 规 
则 又 包括 目标 (Target) 、 依 赖 (Prerequisite) 和 命令 (Command) 。 
Makefile 的 基本 结构 如 下 : 


TARGET... : PREREQUISITE... 
COMMAND 


Make 通 过 一 系列 目标 和 依赖 将 整个 构建 过 程 串联 起 来 ， 同 时 利用 
本 地 命令 完成 每 个 目标 的 实际 行为 。Make 的 强大 之 处 在 于 它 可 以 利用 
所 有 系统 的 本 地 命令 ， 尤 其 是 UNIX/Linux 系 统 ， 丰 富 的 功能 、 强 大 的 命 
令 能 够 帮助 Make 快 速 高 效 地 完成 任务 。 





但 是 ，Make 将 目 己 和 操作 系统 绑 定 在 一 起 了 。 也 就 是 说 ， 使 用 
Make, WAREK CEDIR) 路 平台 的 构建 ， 这 对 于 Java 来 说 是 非常 


不 友好 的 。 此 外 ，Makefile 的 语法 也 成 问题 ， 很 多 人 抱 仿 Make 构 建 失 败 
的 原因 往往 是 一 个 难以 发 现 的 空格 或 Tab 使 用 错误 。 


1.2.4 Ant 





Ant 不 是 指 蚂蚁 ， 而 是 意 指 “ 另 一 个 整洁 的 工具 ”(Another Neat 
Tool) ， 它 最 早 用 来 构建 著名 的 Tomcat， 其 作者 James Duncan Davidson 
创作 它 的 动机 就 是 因为 受 不 了 Makefile 的 语法 格式 。 我 们 可 以 将 Ant 看 成 
是 一 个 Java 上 版 本 的 Make， 也 正 因为 使 用 了 Java，Ant 是 路 平台 的 。 此 
外 ，Ant 使 用 XML 定义 构建 脚本 ， 相 对 于 Makefile 来 说 ， 这 也 更 加 友 
I 











与 Make 类 似 ，Ant 有 一 个 构建 脚本 build.xml， 如 下 所 示 : 


xr ersion -= "] 
yroject name = "Hello" default mee le"> 
<target name = "compile" na ti ple the Java source code to class 
LLCS 
<mkdir dir ="classes"/> 
<javac srcdir="." destdir ="classes"/> 
/target > 


<target name = "jar" depends = "compile" description = "create a Jar file" 
<jar destfile="hello.jar"> 
<fileset dir ="classes" includes ="* * /* .class"/> 
<manifest > 
<attribute name = "Main-Class" value = "HelloProgram"/> 





build.xml 的 基本 结构 也 是 目标 (target) 、 依 赖 Cdepends) , LAK 
实现 目标 的 任务 。 比 如 在 上 面 的 脚本 中 ，jar 目 标 用 来 创建 应 用 程序 jar 文 
件 ， 该 目标 依赖 于 compile 目 标 ， 后 者 执行 的 任务 是 创建 一 个 名 为 classes 


的 文件 夹 ， 编 译 当前 目录 的 java 文 件 人 至 classes 目 录 。compile 目 标 完成 
后 ，jar 目 标 再 执行 自己 的 任务 。Ant 有 大 量 内 置 的 用 Java 实 现 的 任务 ， 
这 保证 了 其 跨 平 台 的 特质 ， 同 时 ，Ant 也 有 特殊 的 任务 exec 来 执行 本 地 


AA 
So 





ua 


和 Make 一 样 ，Ant 也 都 是 过 程式 的 ， 开 发 者 显 式 地 指定 每 一 个 目 
标 ， 以 及 完成 该 目标 所 需要 执行 的 任务 。 针 对 每 一 个 项 目 ， 开 发 者 都 需 
要 重新 编写 这 一 过 程 ， 这 里 其 实 隐 舍 着 很 大 的 重复 。Maven 是 声明 式 
的 ， 项 目 构建 过 程 和 过 程 各 个 阶段 所 需 的 工作 都 由 插件 实现 ， 并 且 大 部 
分 插件 部 是 现成 的 ， 开 发 者 只 需要 声明 项 目的 基本 元 素 ，Maven 束 执行 
内 置 的 、 完 整 的 构建 过 程 。 这 在 很 大 程度 上 消除 了 重复 。 








Ant 是 没有 依赖 管理 的 ， 所 以 很 长 一 段 时 间 Ant 用 户 都 不 得 不 手工 管 
理 依 赖 ， 这 是 一 个 令 人 头疼 的 问题 。 幸 运 的 是 ，Ant 用 户 现在 可 以 借助 
Ivy 管 理 依赖 。 而 对 于 Maven 用 户 来 说， 依赖 管理 是 理所当然 的 ，Maven 
不 仅 内 置 了 依赖 管理 ， 更 有 一 个 可 能 拥有 全 世界 最 多 Java 开 源 软件 包 的 
中 央 仓 库 ，Maven 用 户 无 须 进 行 任何 配置 就 可 以 直接 享用 。 











1.2.5 不 重复 发 明 轮 子 叫 


小 张 是 一 家 小 型 民营 软件 公司 的 程序 员 ， 他 所 在 的 公司 要 开发 一 个 
新 的 web 项目。 经 过 协商 ， 决 定 使 用 Spring、iBatis 和 Tapstry。jar 包 去 哪 
里 找 呢 ?公司 里 估计 没有 人 能 把 Spring、iBatis 和 Tapstry 所 使 用 的 jar 包 一 
个 不 少 地 找 出 来 。 大 家 的 做 法 是 ， 先 到 Spring 的 站 点 上 去 找 一 个 spring- 
with-dependencies， 然 后 去 iBatis 的 网 站 上 把 所 有 列 出 来 的 jar 包 下 载 下 
来 ， 对 Tapstry、Apache commons 等 执行 同样 的 操作 。 项 目 还 没有 开 
始 ，WEB-INF/lib 下 己 经 有 近 百 个 jar 包 了 ， 带 版 本 号 的 、 不 带 版 本 号 
的 、 有 用 的 、 没 用 的 、 相 冲突 的 ， 怎 一 个 “ 乱 ” 字 了 得 ! 





在 项 目 开 发 过 程 中 ， 小 张 不 时 地 发 现 版 本 错误 和 版 本 冲突 问题 ， 他 
只 能 便 着 头皮 逐一 解决 。 项 目 开发 到 一 半 ， 经 理发 现 最 终 部 署 的 应 用 的 
体积 实在 太 大 了 ， 要 求 小 张 去 掉 一 些 没 用 的 jar 包 ， 于 是 小 张 只 能 加 班 加 
点 地 一 个 个 删 .……. 








小 张 隐 隐 地 党 得 这 些 依 赖 需要 一 个 框架 或 者 系统 来 进行 管理 。 


小 张 喜欢 学 习 流 行 的 技术 ， 前 几 年 Ant 十 分 流行 ， 他 学 了 ， 并 成 为 
了 公司 这 方面 的 专家 。 小 张 知 道 ，Ant 打 包 ， 无 非 就 是 创建 目录 ， 复 制 
文件 ， 编 译 源 代码 ， 使 用 一 堆 任 务 ， 如 copydir、fileset、classpath、 
ref、target， 然 后 再 jar、zip、war， 打 包 就 成 功 了 。 


项 目 经 理发 话 了 : OUI, MAAKT, MK, oS Anti 
KI 


“是 ， 保 证 完成 任务 ! ?接着 ， 小 张 继 续 创建 一 个 新 的 XML 文件 。 
target clean; target compile; target jar; ...... 不 知道 他 是 否 想 过 ， 在 他 与 
的 这 么 多 的 Ant 脚 本 中 ， 有 多 少 是 重复 劳动 ， 有 多 少 代 码 会 在 一 个 又 一 
个 项 目 中 重 现 。 既 然 都 差不多 ， 有 些 甚至 完全 相同 ， 为 什么 每 次 都 要 重 
新 编写 ? 











终于 有 一 天 ， 小 张 意识 到 了 这 个 问题 ， 想 复 用 Ant 脚 本 ， 于 是 在 开 
会 时 他 说 :“ 以 后 就 都 用 我 这 个 规范 的 Ant 脚 本 吧 ， 新 的 项 目 只 要 遵循 我 
定义 的 目录 结构 就 可 以 了 。” 经 理 听 后 觉得 很 有 道理 :“ 咽 ， 确 实 是 个 进 








tk ” 
ZV o 


这 时 新 来 的 研究 生发 言 了 : “经 理 ， 用 Maven 吧 ， 这 个 在 开源 社区 
很 流行 ， 比 Ant 更 方便 。? 小 张 一 听 很 惊讶 ，Maven 真 比 目 己 的 “规范 化 
Ant" 强 大 ? 其 实 他 不 知道 自己 只 是 在 重新 发 明 轮 子 ，Maven 已 经 有 一 大 
把 现成 的 插件 ， 全 世界 都 在 用 ， 你 自己 不 用 写 任何 代码 ! 





为 什么 没有 人 说 “我 目 己 写 的 代码 最 灵活 ， 所 以 我 不 用 Spring， 我 目 
己 实 现 IoC， 我 不 用 Hibernate， 我 自己 封装 JDBC”? 


[1] 该 小 节 内 容 整 理 自 网 友 Arthas 最 早 在 Maven 中 文 MSN 群 中 的 讨论 ， 在 
此 表示 感谢 


1.3 Maven 与 极限 编程 


极限 编程 《XP) 是 近 些 年 在 软件 行业 红 得 发 紧 的 敏捷 开发 方法 ， 
它 强 调 拥 抱 变 化 。 该 软件 开发 方法 的 创始 人 Kent Beck 提 出 了 XP 所 退 求 
的 价值 、 实 施 原 则 和 推荐 实践 。 下 和 面 看 一 下 Maven 是 如 何 适 应 XP 的 。 


首先 看 一 下 Maven 如 何 帮 助 XP 团队 实现 一 些 核心 价值 : 


向 单 。Maven 暴 露 了 一 组 一 致 、 简 洁 的 操作 接口 ， 能 帮助 团队 成 员 
从 原来 的 高 度 目 定义 的 、 复 杂 的 构建 系统 中 解脱 出 来 ， 使 用 Maven 现 有 
的 成 熟 的 、 稳 定 的 组 件 也 能 简化 构建 系统 的 复杂 上 度 。 





交流 与 反馈 。 与 版 本 控制 系统 结合 后 ， 所 有 人 都 能 执行 最 新 的 构 
建 并 快速 得 到 有 反馈。 此外， 自动 生成 的 项 目 报告 也 能 帮助 成 员 了 解 项 目 
的 状态 ， 促 进 团 队 的 交流 。 


此 外 ，Maven 更 能 无 颖 地 支持 或 者 融入 到 一 些 主要 的 XP 实践 中 : 


测试 驱动 开发 (TDD) 。TDD 强 调 测试 先行 ， 所 有 产品 都 应 该 由 
测试 用 例 履 新 。 而 测试 是 Maven 和 生命 周期 的 最 重要 的 组 成 部 分 之 一 ， 并 
且 Maven 有 现成 的 成 熟 插 件 支 持 业 界 流行 的 测试 框架 ， 如 JUnit 和 
TestNG. 


十 分 钟 构 建 。 十 分 钟 构 建 强调 我 们 能 够 随时 快速 地 从 源码 构建 出 


最 终 的 产品 。 这 正 是 Maven 所 擅长 的 ， 只 需要 一 些 配置 ， 之 后 用 一 条 简 
单 的 命令 就 能 让 Maven 帮 你 清理 、 编 译 、 测 试 、 打 包 、 部 署 ， 然 后 得 到 


最 终 的 产品 。 





-持续 集成 《CI) 。CI 强 调 项 目 以 很 短 的 周期 《如 15 分 钟 ) 集成 最 
新 的 代码 。 实 际 上 ，CI 的 前 提 是 源码 管理 系统 和 构建 系统 。 目 前 业界 流 
行 的 CI 服务 器 如 Hudson 和 CruiseControl 都 能 很 好 地 和 Maven 进 行 集成 。 
也 就 是 说 ， 使 用 Maven 后 ， 持 续集 成 会 变 得 更 加 方便 。 


:让 有 信息 的 工作 区 。 这 条 实践 强调 开发 者 能 够 快速 方便 地 了 解 到 
项 目的 最 新 状态 。 当 然 ，Maven 并 不 会 帮 你 把 测试 履 盖 率 报 告 贴 到 墙 
上 上 上， 也 不 会 在 你 的 工作 台 上 放 个 鸭子 告诉 你 构建 失败 了 。 不 过 使 用 
Maven 有 发 布 的 项 目 报告 站 点 ， 并 配置 你 需要 的 项 目 报告 ， 如 测试 覆盖 率 
报告 ， 都 能 帮 你 把 信息 推送 到 开发 者 眼前 。 





上 述 这 些 实践 并 非 只 在 XP 中 适用 。 事 实 上 ， 除 了 其 他 敏捷 开发 方 
法 如 SCRUM 之 外 ， 几 乎 任何 软件 开发 方法 都 能 借鉴 这 些 实践 。 也 就 是 
说 ，Maven 几乎 能 够 很 好 地 支持 任何 软件 开发 方法 。 


例如 ， 在 传统 的 瀑布 模型 开发 中 ， 项 目 依次 要 经 历 需 求 开 及 、 分 
析 、 设 计 、 编 码 、 测 试 和 集成 发 布 阶段 。 从 设计 和 编码 阶段 开始 ， 就 可 
以 使 用 Maven 来 建立 项 目的 构建 系统 。 在 设计 阶段 ， 也 完全 可 以 针对 设 
计 开 发 测试 用 例 ， 然 后 再 编写 代码 来 满足 这 些 测试 用 例 。 然 而 ， 有 了 目 


动 化 构建 系统 ， 我 们 可 以 节省 很 多 手动 的 测试 时 间 。 此 外 ， 尽 早 地 使 用 
构建 系统 集成 团队 的 代码 ， 对 项 目 也 是 百 利 而 无 一 害 。 最 后 ，Maven 还 
能 帮助 我 们 快速 地 发 布 项 目 。 








1.4 被 误解 的 Maven 


C++ 之 父 Bjarne Stroustrup 说 过 一 句 话 : “只 有 两 类 计算 机 语言 ， 一 
类 语言 天 天 被 人 器， 还 有 一 类 没 人 用 。?” 当 然 这 话 也 不 全 对 ， 大 红 大 紫 
的 Ruby 不 仅 有 人 用 ， 而 且 加 的 人 也 少 。 用 户 最 多 的 Java 得 到 的 号 声 就 不 
绝 于 耳 了 。Maven 的 用 户 也 不 少 ， 它 的 邮件 列表 目前 在 Apache 项 目 中 排 
名 第 4 Chttp://www.nabble.com/Apache-f 90.html) 。 


让 我 们 看 看 Maven 受 到 了 哪些 质疑 ， 笔 者 将 对 这 些 质疑 逐一 解释 。 


“Maven 对 于 IDE〈 如 Eclipse 和 IDEA) 的 支持 较 差 ，bug 多 ， 而 且 不 
稳定 。” 


相对 于 JUnit 和 Ant 来 说 ，Maven 比 较 年 轻 ，IDE 集 成 等 衍生 产品 还 不 
够 全 面 和 成 熟 。 但 是 ， 我 们 一 定 要 知道 ， 使 用 Maven 最 高 效 的 方式 永远 
是 命令 行 ，IDE 在 自动 化 构建 方面 有 天 生 的 缺陷 。 此 外 ，Eclipse 的 
Maven 插 件 一 一 m2eclipse 是 一 个 比较 优秀 和 成 熟 的 工具 ，NetBeans 也 在 
积极 地 为 更 好 地 集成 Maven 而 努力 ， 自 Intellij IDEA 开 源 后 ， 也 有 望 看 到 
其 对 Maven 更 好 的 集成 。 


“Maven 采 用 了 一 个 糟糕 的 插件 系统 来 执行 构建 ， 新 的 、 破 损 的 择 
件 会 让 你 的 构建 莫名 其 妙 地 失败 。” 





目 Maven 2.0.9 开 始 ， 所 有 核心 的 插件 都 设 定 了 稳定 版 本 ， 这 意味 着 
日 第 使 用 Maven 时 几乎 不 会 受到 不 稳定 插件 的 有 影响。 此外，Maven 社 区 
也 提倡 为 你 使 用 的 任何 插件 设 定 稳 定 的 版 本 。 如 果 我 们 有 好 的 实践 不 采 
纳 ， 遇 到 了 问题 束 抱 忽 ， 未 免 不 够 公允 。 从 Maven 3 开始 ， 如 果 你 使 用 
插件 时 未 设 定 版 本 ， 会 看 到 警告 信息 。 











“Maven 过 于 复杂 ， 它 就 是 构建 系统 的 EJB 2。” 


不 要 指望 Maven 十 分 简单 ， 这 几乎 是 不 可 能 的 。Maven 是 用 来 管理 
项 上 目的， 清理、 编译 、 测 试 、 打 包 、 发 布 ， 以 及 一 些 自 定义 的 过 程 本 和 号 
就 是 一 件 复杂 的 事情 。 目 前 在 Java 社 区 还 有 比 Maven 更 强大 、 更 简单 的 
构建 工具 吗 ? 答案 是 否定 的 。 我 们 可 以 尝试 去 帮助 Maven 让 它 变 得 更 简 
单 ， 而 不 是 抛弃 它 ， 然 后 目 己 实现 一 套 更 加 复杂 的 构建 系统 。 











“Maven 的 仓库 十 分 混乱 ， 当 无 法 从 仓库 中 得 到 需要 的 类 库 时 ， 我 
需要 手工 下 载 复制 到 本 地 仓库 中 。” 





Maven 的 中 央 仓 库 确 实 不 完美 ， 你 也 许 会 发 现 茶 个 jar 包 出 现在 两 个 
不 同 的 路 径 下 。 这 不 是 Maven 的 错 ， 这 是 开源 项 目 本 身 改变 了 目 身 的 坐 
标 。 如 果 疫 有 中 央 人 仓库， 你 将 不 得 不 去 开源 项 目 首页 寻找 下 载 链接 ， 这 
不 是 更 费事 吗 ? 现在 有 很 多 的 Maven 仓 库 搜索 服务 。 无 法 从 中 央 仓 库 找 
到 你 需要 的 类 库 ? 由 于 许可 证 等 因 系 ， 这 是 完全 有 可 能 的 ， 这 时 你 需要 
做 的 是 建立 一 个 组 织 内 部 的 仓库 服务 器 ， 你 会 发 现 这 会 给 你 带 来 许多 意 











想不到 的 好 处 。 
“缺乏 文档 是 理解 和 使 用 Maven 的 一 个 主要 障碍 ! ” 


这 是 事实 。Maven 官 方 站 点 的 文档 十 分 凌乱 ， 各 种 插件 的 文档 更 是 
需要 费力 寻找 。Sonatype 编 写 的 《Maven 权 威 指南 》 很 好 地 改善 了 这 一 
状况 ， 但 由 于 该 书 的 某 些 部 分 与 国内 的 现状 有 些 脱离 ， 且 翻译 速度 无 法 
跟 上 原版 的 更 新 速度 ， 于 是 笔者 编写 本 书 ， 目 的 也 是 帮助 大 家 理解 和 使 


用 Maven 。 
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本 章 只 是 从 概念 上 简单 地 介绍 了 一 下 Maven， 通 过 本 章 我 们 应 该 能 
大 致 了 解 Maven 是 什么 ， 以 及 它 有 什么 用 途 。 我 们 还 将 Maven 与 其 他 这 
行 的 构建 工具 《如 Make 和 Ant) 做 了 一 些 比较 和 分 析 。 如 果 你 没 用 过 
Maven， 但 有 Make 或 者 Ant 的 使 用 经 验 ， 相 信 通 过 比较 你 能 更 清楚 地 了 
解 各 种 工具 的 优 劣 ， 并 且 会 对 Maven 有 一 个 理性 的 认识 。 


将 Maven 和 极限 编程 结合 起 来 分 析 是 为 了 让 大 家 从 男 一 个 角度 了 解 
Maven， 毕 况 软 件 开发 离 不 开 对 于 软件 过 程 的 理解 。 


本 章 最 后 还 收集 了 一 些 用 户 对 Maven 的 误解 ， 并 逐条 进行 了 分 析 和 
解释 ， 和 希望 能 够 消除 大 家 的 误解 ， 从 而 积极 地 接受 Maven， 最 终 从 


Maven 中 受益 。 


第 2 章 “Maven 的 安装 和 配置 

本 章 内 容 

.在 Windows 上 安装 Maven 

在 基于 UNIX 的 系统 上 安装 Maven 

安装 目录 分 析 

:设置 HTTP 代 理 

.安装 m2eslipse 

.安装 NetBeans Maven 插 件 

.Maven 安 装 最 佳 实践 

:小结 


第 1 章 介 绍 了 Maven 是 什么 ， 以 及 为 什么 要 使 用 Maven， 我 们 将 从 本 
章 开始 实际 接触 Maven。 本 章 首 先 将 介绍 如 何在 主流 的 操作 系统 下 安装 
Maven， 并 详细 解释 Maven 的 安 逆 文件 ， 其 次 还 会 介绍 如 何在 主流 的 
IDE 中 集成 Maven， 以 及 Maven 安 装 的 最 佳 实践 。 


2.1 在 Windows 上 安装 Maven 


2.1.1 检查 JDK 安 装 


在 安装 Maven 之 前 ， 首 先 要 确认 你 已 经 正确 安装 了 JDK。Maven 可 
以 运行 在 JDK 1.4 及 以 上 的 版 本 上 。 本 书 的 所 有 样 例 都 基于 JDK 5 及 以 上 
版 本 。 打 开 Windows 的 命令 行 ， 运 行 如 下 的 命令 来 检查 Java 安 装 : 








结果 如 图 2-1 所 示 : 


>: Wsers\Juven Kudecho ~JAUA_HOMEZ 
D: \java\jdki .6.6_87 


S: WsersWuven Ku>java -version 


java version "1.6.0_07" 
JavaCIM> SE Runtime Environment Cbhuild 1.6.6_8@7-b86> 
ava HotSpot¢<TM> Client UM Chuild 16.@-b23,. mixed mode. sharing? 





图 2-1 Windows 中 检查 Java 安 装 








上 述 命令 首先 检查 环境 变量 JAVA_HOME 是 否 指向 了 正确 的 JDK 目 
录 ， 接 着 尝试 运行 java 命 令 。 如 果 Windows 无 法 执行 java 命 令 ， 或 者 无 法 
找到 JAVA_HOME 环 境 变量 ， 就 需要 检查 Java 是 个 安装 了 ， 或 者 环境 变 
量 是 人 否 设 置 正确 。 关 于 环境 变量 的 设置 ， 请 参考 2.1.3 市 。 








2.1.2 下载 Maven 


请 访问 Maven 的 下 载 页 面 : http://maven.apache.org/download.html， 
其 中 包含 针对 不 同 平台 的 各 种 版 本 的 Maven 下 载 文 件 。 对 于 首次 接触 
Maven 的 读者 来 说 ， 推 荐 使 用 Maven 3.0， 因 此 需要 下 载 apache-maven- 
3.0-bin.zip。 当 然 ， 如 果 你 对 Maven 的 源 代码 感 兴趣 并 想 自己 构建 
Maven， 还 可 以 下 载 apache-maven-3.0-src.zip。 该 下 载 页 面 还 提供 了 md5 
BEF (checksum) 文件 和 asc 数 字 签 名 文件 ， 可 以 用 来 检验 Maven 分 发 
包 的 正确 性 和 安全 性 。 


在 编写 本 书 的 时 候 ，Maven 2 的 最 新 版 本 是 2.2.1，Maven 3 基本 完全 
兼容 Maven 2， 而 且 比 Maven 2 的 性 能 更 好 ， 还 对 其 中 某 些 功能 进行 了 改 
进 。 如 果 你 之 前 一 直 使 用 Maven 2， 现 在 正 犹豫 是 否 要 升级 ， 那 就 大 可 
不 必 担 心 了 ， 快 点 尝试 一 下 Maven 3 吧 ! 


21.3 AHA 


将 安装 文件 解压 到 指定 的 目录 中 ， 如 : 
D:\bin>jar xvf "C:\Users \Juven Ku \Downloads \apache-maven-3.0 bin.zip" 


这 里 的 Maven 安 装 目录 是 D: \bin\apache-maven-3.0， 接 着 需要 设置 
环境 变量 ， 将 Maven 安 装配 置 到 操作 系统 环境 中 。 


打开 系统 属性 面板 〈 在 桌面 上 右 击 “ 我 的 电脑 ”~ “属性 ?>) ， 单 击 高 
级 系统 设置 ， 再 单 击 环境 变量 ， 在 系统 变量 中 新 建 一 个 变量 ， 变 量 名 为 
M2_HOME， 变 量 值 为 Maven 的 安装 目录 D: \binvapache-maven-3.0。 单 
击 “ 确 定 ?按钮 ， 接 着 在 系统 变量 中 找到 一 个 名 为 Path 的 变量 ， 在 变量 值 
的 末尾 加 上 %M2_HOME%\bin; 。 注 意 : 多 个 值 之 间 需 要 有 分 号 隔 开 ， 
然后 单 击 “ 确 定 ” 按 钮 。 至 此 ， 环 境 变量 设置 完成 。 详 细 情 况 如 图 2-2 所 
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要 进行 大 多 数 更 羽 ， 您 必须 作为 管理 员 登 录 。 











Juven Xu 的 用 户 变量 an 
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图 2-2 Windows 中 系统 环境 变量 配置 





值得 注意 的 是 Path 环 境 变量 。 当 我 们 在 cmd 中 输入 命令 时 ， 
Windows 首 先 会 在 当前 目录 中 寻找 可 执行 文件 或 脚本 ， 如 果 没 有 找到 ， 
Windows 会 接着 遍历 环境 变量 Path 中 定义 的 路 径 。 由 于 
将 %M2_HOME%\bin 添 加 到 了 Path 中 ， 而 这 里 %M2_HOME% 实 际 上 是 
引用 了 前 面 定义 的 另 一 个 变量 ， 其 值 是 Maven 的 安装 目录 。 因 此 ， 














Windows 会 在 执行 命令 时 搜索 目录 D: \bin\apache-maven-3.0\bin, mvn 
执行 脚本 的 位 置 就 是 这 里 。 


了 解 环境 变量 的 作用 之 后 ， 现 在 打开 一 个 新 的 cmd 窗 口 ( 这 里 强调 
新 的 窗口 是 因为 新 的 环境 变量 配置 需要 新 的 cmd 窗 口才 能 生效 ) ， 运 行 
如 下 命令 检查 Maven 的 安装 情况 : 





`; Users \Juven Xu >echo % M2_HOME% 
C: Users \Juven Xu >mvn-v 


运行 结果 如 图 2-3 所 示 。 





D:\>echo ~M2_HOMEx 
ID = Nbin Napac he-—maven—3 .6 


D:N>mun —v 

Apache Maven 3.6 (996106; 2616-89-11 17:32:16+8868> 
Java version: 1.6.6_67 

Java home: D:\java\jdki.6.6_67\jre 

Default locale: zh_CN. platform encoding: GB18030 


z= “windows uista" version: "6.0" arch: "x86" Family: "windows" 














图 2-3 ”Windows 中 检查 Maven 安 装 





第 一 条 命令 echo%M2_HOME% 用 来 检查 环境 变量 M2_HOME 是 和 否 
指向 了 正确 的 Maven 安 装 日 录 ; 而 mvn-v 执 行 了 第 一 条 Maven 命 令 ， 以 检 
查 Windows 是 否 能 够 找到 正确 的 mvn 执 行 脚本 。 


2.1.4 升级 Maven 


Maven 蝎 新 比较 频繁 ， 因 此 用 户 往 往 会 需要 更 新 Maven 安 装 以 获得 
更 多 、 更 酷 的 新 特性 ， 并 避免 一 些 旧 的 bug。 


在 Windows 上 更 新 Maven 非 党 简便 ， 只 需要 下 载 新 的 Maven 安 闭 文 
件 ， 解 压 至 本 地 目录 ， 然 后 更 新 M2_HOME 环 境 变量 即 可 。 例 如 ， 假 设 
Maven 推 出 了 新 版 本 3.1， 我 们 将 其 下 载 然后 解压 至 目录 D:， \bin\apache- 
maven-3.1， 接 着 遵照 前 一 闻 揪 述 的 步 又 编辑 环境 变量 M2_HOME， 更 改 
其 值 为 D: \binvapache-maven-3.1。 至 此 ， 更 新 就 完成 了 。 同 理 ， 如 果 需 
要 使 用 某 一 个 旧版 本 的 Maven， 也 只 需要 编辑 M2_HOME 环 境 变 量 指向 
旧版 本 的 安装 目录 。 





2.2 ”在 基于 UNIX 的 系统 上 安装 Maven 


Maven 是 路 平台 的 ， 它 可 以 在 任何 一 种 主流 的 操作 系统 上 运行 。 本 
节 将 介绍 如 何在 基于 UNIX 的 系统 (包括 Linux、Mac OS 以 及 FreeBSD 


节 
等 ) 上 安装 Maven。 


2.2.1 下 载 和 安装 


首先 ， 与 在 Windows 上 安装 Maven 一 样 ， 需 要 检查 JAVA_HOME 环 
境 变 量 以 及 Java 命 令 ， 这 里 对 细节 不 再 葡 述 。 命 令 如 下 : 


运行 结果 如 图 2-4 所 示 。 


juven@juven-ubuntu:~$ echo SJAVA HOME 
/usr/lLocal/jdk1.6.0 11 
juven@juven-ubuntu:~$ java -version 


java version "1.6.0 11" 
Java(T™) SE Runtime Environment (build 1.6.0 11-b03) 
Java HotSpot(TM) Server VM (build 11.0-b16, mixed mode) 


图 2-4 Linux 中 检查 Java 安 装 





接着 到 http://maven.apache.org/download.html 下 载 Maven 安 装 文件 ， 
如 apache-maven-3.0-bin.tar.gz， 然 后 解压 到 本 地 目录 : 


现在 已 经 创建 好 了 一 个 Maven 安 装 目录 apache-maven-3.0。 虽 然 直接 
使 用 该 目录 配置 环境 变量 之 后 就 能 使 用 Maven 了 ， 但 这 里 的 推荐 做 法 
是 ， 在 安装 目录 劳 平 行 地 创建 一 个 符号 链接 ， 以 方便 日 后 的 升级 : 


接 下 来 ， 需 要 设置 M2_HOME 环 境 变 量 指 癌 符号 链接 apache- 
maven-， 并 且 把 Maven 安 装 有 目录 下 的 bin/ 文 件 夹 添加 到 系统 环境 变量 
PATH: 


HOME = ome / juven/bin /apache-maven 


M2 
PATH 


H = $ PATH: $M2_HOME/bin 


juven@ juven-ubuntu:bin $ export 


一 般 来 说 ， 需 要 将 这 两 行 命 令 加 入 到 系统 的 登录 shell 脚 本 中 去 ， 以 
Ubuntu 8.10 为 例 ， 编 辑 ~/.bashrc 文 件 ， 添 加 这 两 行 命 令 。 这 样 ， 每 次 局 


动 一 个 终端 ， 这 些 配 置 就 能 自动 执行 。 








至 此 ， 安 装 完成 。 可 以 运行 以 下 命令 检查 Maven 安 装 : 





图 2-5” ”Linux 中 检查 Maven 安 装 


2.2.2 ”升级 Maven 


在 基于 UNIX 的 系统 上 ， 可 以 利用 符号 链接 这 一 工具 来 简化 Maven 
的 升级 ， 不 必 像 在 Windows 上 那样 ， 每 次 升级 都 必须 更 新 环境 变量 。 


前 一 小 节 中 我 们 提 到 ， 解 压 Maven 安 装 包 到 本 地 之 后 ， 平 行 地 创建 
一 个 符号 链接 ， 然 后 在 配置 环境 变量 时 引用 该 符号 链接 ， 这 样 做 是 为 了 
方便 升级 。 现 在 ， 假 设 需 要 升级 到 新 的 Maven 3.1 版 本 ， 将 安装 包 解 压 
到 与 前 一 版 本 平行 的 目录 下 ， 然 后 更 新 符号 链接 指 癌 3.1 版 的 目录 便 





juven@ juven-ubuntu:binS rm apache-maven 


juven@ juven-ubuntu:bin$ ln-s apache-maven-3.1/apache-maven 
juven@ juven-ubuntu:bin$ ls-] 
total 8 
rwxrwxrwx 1 juven juven 17 2009 -09 -20 16:13 apache-mav -> apache-maven-3.1/ 


€ en 
drwxr-xr-x 6 juven juven 4096 2009 -09 -20 15:39 apache-maven-3.0 


. U 
arwxr-xr-x 2 juven juven 4096 2009 -09 -20 16:09 apache-maven-3.1 


同 理 ， 可 以 很 方便 地 切换 到 Maven 的 任意 一 个 版 本 。 现 在 升级 完成 
了 ， 可 以 运行 nvn-v 进 行 检 查 。 





2.3 aA RAT 


前 面 讲 述 了 如 何在 各 种 操作 系统 中 安装 和 升级 Maven。 现 在 来 仔细 
分 析 一 下 Maven 的 安装 文件 。 


2.3.1 M2 HOME 


前 面 讲 到 设置 M2_HOME 环 境 变 量 指 同 Maven 的 安装 有 目录， 本 书 之 
后 所 有 使 用 M2_HOME 的 地 方 都 指 代 了 该 安装 目录 。 下 面 看 一 下 该 目录 
的 结构 和 内 容 : 





bin: 该 目录 包含 了 mvn 运 行 的 脚本 ， 这 些 脚 本 用 来 配置 Java 命 令 ， 
准备 好 classpath 和 相关 的 Java 系 统 属 性 ， 然 后 执行 Java 命 令 。 其 中 mvn 是 
基于 UNIX 平 台 的 shell 脚 本 ，mvn.bat 是 基于 Windows 平 台 的 bat 脚 本 。 在 
命令 行 输入 任何 一 条 mvn 命 令 时 ， 实 际 上 就 是 在 调用 这 些 脚 本 。 该 目录 
还 包含 了 mvnDebug 和 mvnDebug.bat 两 个 文件 ， 同 样 ， 前 者 是 UNIX 平 台 
的 shell 脚 本 ， 后 者 是 Windows 平 人 台 的 bat 脚 本 。 那 么 mvn 和 mvnDebug 有 什 
么 区 别 和 关系 呢 ? 打开 文件 我 们 就 可 以 看 到 ， 两 者 基本 是 一 样 的 ， 只 是 
mvnDebug 多 了 一 条 MAVEN_DEBUG_OPTS 配 置 ， 其 作用 就 是 在 运行 
Maven 时 开启 debug， 以 便 调试 Maven 本 身 。 此 外 ， 该 目录 还 包含 
m2.conf 文 件 ， 这 是 classworlds 的 配置 文件 ， 后 面 会 介绍 classworlds。 





‘boot: 该 目录 只 包含 一 个 文件 ， 以 maven 3.0 为 例 ， 该 文件 为 
plexus-classworlds-2.2.3.jar。plexus-classworlds 是 一 个 类 加 载 器 框架 ， 相 
对 于 默认 的 java 类 加 载 器 ， 它 提供 了 更 丰富 的 语法 以 方便 配置 ，Maven 
使 用 该 框架 加 载 自己 的 类 库 。 更 多 关于 classworlds 的 信息 请 参 
考 http://classworlds.codehaus.org/。 对 于 一 般 的 Maven 用 户 来 说 ， 不 必 关 
心 该 文件 。 





‘conf: 该 目录 包含 了 一 个 非常 重要 的 文件 settings.xml。 直 接 修改 该 
文件 ， 就 能 在 机 器 上 全 局 地 定制 Maven 的 行为 。 一 般 情况 下 ， 我 们 更 偏 
向 于 复制 该 文件 至 ~/.m2/ 目 录 下 (~ 表示 用 户 目 录 ) ， 然 后 修改 该 文件 ， 
在 用 户 范围 定制 Maven 的 行为 。 后 面 将 会 多 次 提 到 settings.xml， 并 逐步 
分 析 其 中 的 各 个 元 素 。 








‘lib: 该 目录 包含 了 所 有 Maven 运 行 时 需要 的 Java 类 库 ，Maven 本 喘 
是 分 模块 开发 的 ， 因 此 用 户 能 看 到 诸如 maven-core-3.0.jar、maven- 
model-3.0.jar 之 类 的 文件 。 此 外 ， 这 里 还 包含 一 些 Maven 用 到 的 第 三 方 依 
赖 ， 如 common-cli-1.2.jar、google-collection-1.0.jar 等 。 对 于 Maven 2 来 
说 ， 该 目录 只 包含 一 个 如 maven-2.2.1-uber.jar 的 文件 ， 原 本 各 为 独立 JAR 
文件 的 Maven 模 块 和 第 三 方 类 库 都 被 拆 解 后 重新 合并 到 了 这 个 JAR 文 件 
中 。 可 以 说 ，lib 目 录 就 是 真正 的 Maven。 关 于 该 文件 ， 还 有 一 点 值得 一 
提 的 是 ， 用 户 可 以 在 这 个 目录 中 找到 Maven 内 置 的 超级 POM， 这 一 点 在 
8.5 节 详细 解释 。 其 他 : LICENSE.txt 记 录 了 Maven 使 用 的 软件 许可 证 





Apache License Version 2.0; NOTICE.txt 记 录 了 Maven 包 含 的 第 三 方 软 
件 ， 而 README.txt 则 包含 了 Maven 的 简要 介绍 ， 包 括 安装 需求 及 如 何 


安 逆 的 简要 指令 等 。 





在 讲述 该 小 节 之 前 ， 我 们 先 运行 一 条 简单 的 命令 : mvn help: 
system。 该 命令 会 打印 出 所 有 的 Java 系 统 属性 和 环境 变量 ， 这 些 信息 对 
我 们 日 常 的 编程 工作 很 有 帮助 。 这 里 暂 不 解释 help: system 涉 及 的 语 
法 ， 运 行 这 条 命令 的 目的 是 让 Maven 执 行 一 个 真正 的 任务 。 我 们 可 以 从 
行 输 出 看 到 Maven 会 下 载 maven-help-plugin， 包 括 pom 文 件 和 jar 文 
件 。 这 些 文件 都 被 下 载 到 了 Maven 本 地 仓库 中 。 











=> 


现在 打开 用 户 目 录 ， 比 如 当前 的 用 户 目 录 是 C: \UsersJuven Xu\， 
你 可 以 在 Vista 和 Windows7 中 找到 类 似 的 用 户 目录 。 如 果 是 更 早 版 本 的 
Windows， 该 目录 应 该 类 似 于 C: \Document and Settings\Juven Xu\。 在 
基于 UNIX 的 系统 上 ， 直 接 输入 cd 回 车 ， 就 可 以 转 到 用 户 目录 。 为 了 方 
便 ， 本 书 统 一 使 用 符号 ~ 指 代 用 户 目录 。 


在 用 户 目录 下 可 以 发 现 .m2 文 件 夹 。 默 认 情况 下 ， 该 文件 夹 下 放置 
了 Maven 本 地 仓库 .m2/repository。 所 有 的 Maven 构 件 都 被 存储 到 该 仓库 
中 ， 以 方便 重用 。 可 以 到 
~/.m2/repository/org/apache/maven/plugins/maven-help-plugins/ 目 录 下 找到 
刚才 下 载 的 maven-help-plugin 的 pom 文 件 和 jar 文 件 。Maven 根 据 一 套 规 
则 来 确定 任何 一 个 构件 在 仓库 中 的 位 置 ， 这 一 点 在 第 6 章 将 会 详细 阐 








述 。 由 于 Maven 仓 库 是 通过 简单 文件 系统 透明 地 展示 给 Maven 用 户 的 ， 
有 些 时 候 可 以 绕 过 Maven 直 接 查 看 或 修改 仓库 文件 ， 在 过 到 疑难 问题 
时 ， 这 往往 十 分 有 用 。 





默认 情况 下 ，~/.m2 目 录 下 除了 repository 仓 库 之 外 就 没有 其 他 目录 
和 文件 了 ， 不 过 大 多 数 Maven 用 户 需 要 复制 M2_HOME/conf/settings.xml 
文件 到 ~/.m2/settings.xml。 这 是 一 条 最 佳 实践 ， 我 们 将 在 2.7 小 节 详 细 解 
释 。 


2.4 设置 HTTP 代 理 


有 时 候 你 所 在 的 公司 基于 安全 因素 考虑 ， 要 求 你 使 用 通过 安全 认证 
的 代理 访问 因特网 。 这 种 情况 下 ， 就 需要 为 Maven 配 置 HITP 代 理 ， 才 
能 让 它 正 常 访问 外 部 仓库 ， 以 下 载 所 需要 的 资源 。 





首先 确认 自己 无 法 直接 访问 公共 的 Maven 中 央 仓库 ， 直 接 运 行 命令 
ping repol.maven.org 可 以 检查 网 络 。 如 果真 的 需要 代理 ， 先 检查 一 下 代 
理 服务 器 是 否 畅通 。 比 如 现在 有 一 个 耻 地 址 为 218.14.227.197， 端 口 为 
3128 的 代理 服务 ， 我 们 可 以 运行 telnet 218.14.227.1973128 来 检测 该 地 址 
的 该 端口 是 否 畅 通 。 如 果 得 到 出 错 信息 ， 需 要 先 获取 正确 的 代理 服务 信 
息 ; 如 果 telnet 连 接 正 确 ， 则 输入 ctrlt ]」] ， 然 后 q， 回 车 ， 退 出 即 可 。 


仿 查 完毕 之 后 ， 编 辑 ~/.m2/settings.xml 文 件 〈( 如 果 没 有 该 文件 ， 则 
复制 $M2_HOME/conf/settings.xml)〉。 添 加 代理 配置 如 下 : 


] ly-proxy < Ad 

t >true < e 
protocol >http fe 
h 18.14.2 j t 
por 3128 < /por 





u name 
assword 
2»pository.mycom. com|* .google. com< MonProxyHosts > 
< fore 
< Proxi 
etting 


这 段 配置 十 分 简单 ，proxies 下 可 以 有 多 个 proxy 元 素 ， 如 果 声 明了 
多 个 proxy 元 素 ， 则 默认 情况 下 第 一 个 被 激活 的 proxy 会 生效 。 这 里 声明 
了 一 个 id 为 my-proxy 的 代理 ，active 的 值 为 true 表 示 激 活该 代理 ，protocol 
表示 使 用 的 代理 协议 ， 这 里 是 http。 当 然 ， 最 重要 的 是 指定 正确 的 主机 
Z Cott) 和 端口 〈port 元 素 ) 。 上 述 XML 配 置 中 注释 反 了 
username、password、nonProxyHost 几 个 元 素 。 当 代理 服务 需要 认证 
时 ， 就 需要 配置 username 和 password。nonProxyHost 元 素 用 来 指定 哪些 
主机 名 不 需要 代理 ， 可 以 使 用 “* 符 号 来 分 阳 多 个 主机 名 。 此 外 ， 该 配置 
也 文 持 通配符 ， 如 *.google.com 表 示 所 有 以 google.com 结 尾 的 域名 访问 都 
不 要 通过 代理 。 





2.5 %%m?2eclipse 


Eclipse 是 一 于 非常 优秀 的 IDE。 除 了 基本 的 语法 标 亮 、 代 码 补 齐 、 
XML 编辑 等 基本 功能 外 ， 最 新 版 的 Eclipse 还 能 很 好 地 支持 重 构 ， 并 且 集 
成 了 JUnit、CVS、MYylyn 等 各 种 流行 工具 。 可 惜 Eclipse 默 认 没 有 集成 对 
Maven 的 支持 。 幸 运 的 是 ， 由 Maven 之 父 Jason Van Zyl 创立 的 Sonatype 公 
司 建立 了 m2eclipse 项 目 。 这 是 Eclipse 下 的 一 款 十 分 强大 的 Maven 插 件 ， 


可 以 访问 http://m2eclipse.sonatype.org/ 了 解 更 多 该 项 目的 信息 。 


本 小 节 将 介绍 如 何 安装 m2eclipse 搬 件 ， 后 续 的 章节 会 逐步 介绍 


m2eclipse 插 件 的 使 用 。 


现在 以 Eclipse 3.6 为 例 逐 步 讲 解 m2eclipse 的 安装 。 启 动 Eclipse 之 
后 ， 在 菜单 栏 中 选择 Help， 然 后 选择 Install New Software...， 接 着 你 会 看 
到 一 个 Install 对 话 框 。 单 击 Work with: 字段 边 上 的 Add 按 钮 ， 会 弹出 一 
个 新 的 Add Repository 对 话 框 。 在 Name 字 段 中 输入 m2e， 在 Location 字 段 
中 输入 http://m2eclipse.sonatype.org/sites/m2e， 然 后 单 击 OK 按 钮 。 
Edlipse 会 下 载 m2eclipse 安 装 站 点 上 的 资源 信息 。 等 待 资源 载 入 完成 之 
后 ， 再 将 其 全 部 展开 ， 就 能 看 到 图 2-6 所 示 的 界面 。 





= Install 


Available Software 


Check the items that you wish to install. J 


‘| peer’, “some 





Work with: m2e - http://m2eclipse.sonatype.org/sites/m2e 


v 


Find more software by working with the "Available Software Sites" preferences. 
type filter text 
Name 


Version 
| a M Ul Maven Integration for Eclipse 


而 48 Maven Integration for Eclipse (Required) 0.10.2.20100523-1649 





Deselect All 


Details 





VI Show only the latest versions of available software [F] Hide items that are already installed 
|7] Group items by category What is already installed? 
[7] Contact all update sites during install to find required software 





图 2-6 ”m2eclipse 的 核心 安装 资源 列表 


图 2-6 显 示 了 m2eclipse 的 核心 模块 Maven Integration for 
Eclipse (Required) ， 选 择 后 单 击 Next 按 钮 ，Eclipse 会 自动 计算 模块 间 
依赖， 然后 给 出 一 个 将 被 安装 的 模块 列表 。 确 认 无 误 后 ， 继 续 单 击 Next 


按钮 ， 这 时 会 看 到 许可 证 信息 。m2eclipse 使 用 的 开源 许可 证 是 Eclipse 
Public License v1.0， 选 择 I accept the terms of the license agreements， 然 
后 单 击 Finish 按 钮 ， 接 着 就 耐心 等 竺 Eclipse 下 载 安 装 这 些 模块 ， 如 图 2-7 
所 示 。 


= installing Software 


0 Installing Software 
E 


Fetching org.maven.ide.eclipse.pr_0.10.2.2...n.ide.eclipse.pr_0.10.2.20100623-1649.jar 








| Always run in background 





| Run in Background | | Cancel | F Details >> 














图 2-7 m2edlipse 安 装 进度 


除了 核心 组 件 之 外 ，m2eclipse 还 提供 了 一 组 额外 组 件 ， 主 要 是 为 了 
方便 与 其 他 工具 如 Subversion 进 行 集成 ， 这 些 组 件 的 安装 地 址 
为 http://m2eclipse.sonatype.org/sites/m2e-extras。 使 用 前 面 类 似 的 安装 方 
法 ， 可 以 看 到 图 2-8 所 示 的 组 件 列表 。 

下 面 简单 解释 一 下 这 些 组 件 的 用 途 。 


1. 重 要 的 


‘Maven SCM handler for Subclipse (Optional) : Subversion 是 非常 
流行 的 版 本 管理 工具 。 该 模块 能 够 帮助 我 们 直接 从 Subversion 服 务 器 签 
出 Maven 项 目 ， 不 过 前 提 是 需要 首先 安装 


Subclipse Chttp://subclipse.tigris.org/) 。 








‘Maven SCM Integration (Optional) : Eclipse 环境 中 Maven 与 SCM 
集成 核心 的 模块 。 它 利用 各 种 SCM 工 具 如 SVN 实 现 Maven 项 目的 签 出 和 
具体 化 等 操作 。 


2. 不 重要 的 


-Maven issue tracking configurator for Mylyn 3.x (Optional) : 该 模 
块 能 够 帮助 我 们 使 用 POM 中 的 缺陷 跟踪 系统 信息 连接 Mylyn 全 服务 器 。 


‘Maven SCM handler for Team/CVS (Optional) : 该 模块 帮助 我 们 
从 CVS 服 务 器 签 出 Maven 项 目 ， 如 果 还 在 使 用 CVS， 就 需要 安装 它 。 





-Maven Integration for WTP (Optional) : 使 用 该 模块 可 以 让 Eclipse 
自动 读 取 POM 信 息 并 配置 WTP 项 目 。 


-M2Eclipse Extensions Development Support (Optional) : 用 来 支持 
扩展 m2eclipse， 一 般 用 户 不 会 用 到 。 


Available Software 
Check the items that you wish to install, 





Work with: m2e-extras - http://m2eclipse.sonatype.org/sites/m2e-extras 
Find more software by working with the “Available Software Sites” preferences. 





type filter text 








Name Version 

a [|00 Maven Integration for Eclipse Extras 
同 Yt M2Eclipse Extensions Development Support (Optional) 0.10.0.20100209-0800 
[F Qt Maven Integration for WTP (Optional) 0.10.0.20100209-0800 
E @* Maven issue tracking configurator for Mylyn 3.x (Optional) 0.10.0.20100209-0800 
E @ Maven SCM handler for Subclipse (Optional) 0.10.0.20100209-0800 
[F kt Maven SCM handler for Team/CVS (Optional) 0.10.0.20100209-0800 
[E i Maven SCM Integration (Optional) 0.10.0,20100209-0800 
Im p Project configurators for commonly used maven plugins (temporary) _0.10.0.20100209-0800 


ETTA 


Detalls 
Checkout projects using Maven SCM providers 





{¥| Show only the latest versions of available software |E Hide items that are already installed 
Group Items by category What is already installed? 
[F] Contact all update sites during install to find required software 





@ 








图 2-8 ”m2eclipse 的 额外 组 件 安装 资源 列表 


‘Project configurators for commonly used maven 
plugins (temporary) : 一 个 临时 的 组 件 ， 用 来 文 持 一 些 Maven 插 件 与 
Eclipse 的 集成 ， 建 议 安装 。 





读者 可 以 根据 上 自己 的 需要 安装 相应 组 件 ， 有 具体 步骤 这 里 不 再 痪 述 。 


竺 安装 完毕 后 ， 重 启 Eclipse。 现 在 来 验证 一 下 m2edlipse 是 否 正确 安 





装 了 。 首 先 ， 单 击 菜单 栏 中 的 Heljp， 然 后 选择 About Eclipse。 在 弹出 的 
对 话 框 中 ， 单 击 Installation Details 按 钮 ， 会 得 到 一 个 对 话 框 。 在 Installed 
Software 标 签 中 ， 检 查 刚才 选择 的 模块 是 否 在 这 个 列表 中 ， 如 图 2-9 所 


ZN o 





如 果 一 切 没 问题 ， 再 检查 一 下 Eclipse 现在 是 否 已 经 支持 创建 Maven 
项 目 。 依 次 单 击 菜单 栏 中 的 File~New Other， 在 弹出 的 对 话 框 中 ， 找 
到 Maven 一 项 ， 再 将 其 展开 ， 应 该 能 够 看 到 图 2-10 所 示 的 对 话 框 。 


如 果 一 切 正 常 ， 说 明 m2eclipse 已 经 正确 安装 了 。 


最 后 ， 关 于 m2eclipse 的 安装 需要 提醒 的 一 点 是 ， 你 可 能 会 在 使 用 
m2eclipse 时 遇 到 类 似 这 样 的 错误 : 





Version Id 
{i CollabNet Merge Client 2.1.0 com.collabnet.subversion.merge.featu... 
b i Eclipse IDE for Java Developers 1.3.0.20100617-0.... epp.package,java 
G JNA Library 3.2.3 com.sunjna.feature.group 
p @ Maven Integration for Eclipse (Required) 0,10.2.20100623-... org.maven.ide.eclipse.feature.feature.... 
{gi Maven SCM handler for Subclipse (Optional) 0.10,0.20100209-... org.maven.ide.eclipse.subclipse. featur... 
Q Maven SCM Integration (Optional) 0.10.0.20100209-.。 org.maven.ide.eclipse.scm.feature.feat... 
{i Project configurators for commonly used maven plugit 0.10,0.20100209-... org.maven,ide.eclipse.temporary.mojo... 
&@ Subclipse (Required) 1.6.13 org.tigris.subversion.subclipse.feature.... 
号 Subclipse Integration for Mylyn 3.x (Optional) 3.0.0 org.tigris.subversion.subclipse.mylyn.... 


号 Subversion Client Adapter (Required) 1.6.12 org.tigris.subversion.clientadapter. feat... 
{§ Subversion JavaHL Native Library Adapter (Required) 1.6.12 org.tigris.subversion.clientadapterjav... 

). Subversion Revision Graph 1.0.8 org,tigris.subversion.subclipse.graph.t.., 
{i SVNKit Client Adapter (Not required) 1.6.12 org.tigris.subversion.clientadapter.svn... 
Q SVNKit Library 13.3.6648 org.tmatesoft.svnkit.feature.group 














Maven integration. Launching Maven from Eclipse, dependency management and search. 





2-9 m2eclipse #22445 R 


Select a wizard 
Create a Maven Project 





Wizards: 
|type filter text 





© General 

@ CVS 

> Java 

( Maven 
EI Checkout Maven Projects from SCM 
M Maven Module 
W Maven POM file 
M3 Maven Project 

È SVN 

& Tasks 

@ XML 

& Examples 





图 2-10 Eclipse? | 4!MavenJit H [ay 5 


09 -10 -6 E+ 01 714449 秒 : Eclipse is running in a JRE, but a JDK is required 
Some Maven plugins may not work when importing projects or updating source fold- 
ers. 


这 是 因为 Eclipse 默认 是 运行 在 JRE 上 的 ， 而 m2eclipse 的 一 些 功能 
求 使 用 JDK。 解 决 方法 是 配置 Eclipse 安装 目录 的 eclipse.ini 文 件 ， 添 加 vm 
配置 指向 JDK。 例 如 : 


— launcher. XXMaxPermSize 
256m 


— vm 

D: \java \jdk1.6.0_07 \bin\javaw. exe 
—vmargs 

-Dosgi. requiredJavaVersion =1.5 
—-Xmsl28m 

—Xmx256m 


2.6 安装 NetBeans Maven 插 件 


本 小 节 会 先 介绍 如 何在 NetBeans 上 安装 Maven 搬 件 ， 后 面 的 章节 中 
还 会 介绍 NetBeans 中 有 具体 的 Maven 操 作 。 


如 有 果 正 在 使 用 NetBeans 6.7 及 以 上 版 本 ， 那 么 Maven 插 件 已 经 预 装 
了 。 你 可 以 检查 Maven 插 件 安装 ， 单 击 菜单 栏 中 的 工具 ， 接 首选 择 插 
件 ， 在 弹出 的 插件 对 话 框 中 选择 已 安装 标签 ， 应 该 能 够 看 到 Maven 插 
件 ， 如 图 2-11 所 示 。 





Java 
Java 持 欠 性 上 | 版本: 4.1.3 


Java Profiler 源 : NetBeans IDE 6.7.1 (Build 200907230233) 
Spring Bean 
Ant 


Hibernate | 插件 描述 
开发 


1| TetBeans IDE 支持 Apache Maveno 


amamma 就 


GUL 生成 器 Maven 是 一 个 软件 项 目 管理 和 理解 工具 。 基 于 项 目 对 象 模块 om) 
Java iste FS» Maven 能 管理 项 目 生 成 ， 以 及 来 自 中 心 片 信息 的 报告 和 文档 。 
RCP 平台 cP 平 起 学 习 到 更 条 有 关 Apache Maven， 请 访问 Maven 是 什么 ? 页面 
服务 型 软件 
数据 库 基本 IDE IDE 完全 支持 基于 Maven 的 medatata 句 括 自身 项 目 类 型 ，Waven 
Subversion 项 目 文件 代码 完成 ， 在 IDE 中 集成 其 它 工 具 等 。 

Hudson 

本 地 历史 记录 

IDE 标记 











= 
a 
F 
= 
F 
= 
> 
F 
F 
~ 
= 
=) 





[| eo |[ mateo | | man 











图 2-11 已 安装 的 NetBeans Maven 插 件 


如 果 在 使 用 NetBeans 6.7 之 前 的 版 本 ， 或 者 由 于 某 些 原因 NetBeans 
Mavens FIRER o ASA Whit NetBeans Maven 插 件 。 下 面 以 
NetBeans 6.1 为 例 ， 介 绍 Maven 插 件 的 安装 。 


同样 ， 单 击 菜单 栏 中 的 工具 ， 选 择 插件 ， 在 弹出 的 插件 对 话 框 中 选 
择 可 用 插件 标签 ， 接 着 在 右边 的 搜索 框 内 输入 Maven， 这 时 会 在 左边 的 
列表 中 看 到 一 个 名 为 Maven 的 插件 。 选 择 该 插件 ， 然 后 单 击 下 面 的 “ 安 
装 ” 按 钮 ， 如 图 2-12 所 示 。 








搜索 56): maven 











Netbeans Maven Hints tj 


: The Codehaus 
: 08-10-20 
源 : NetBeans 
c: DAt mevenide. codehaus. org/m2-site 


括 件 描述 


NetBeans IDE support for apache. org” >Apache Maven. 


Maven is a software project management and 
comprehension tool. Based on the concept of a project 
object model (POM), Maven can manage a project's 
build, reporting and documentation from a central 








已 选择 ! Hift» nB 








图 2-12 ”安装 NetBeans Maven 插 件 





接着 在 随后 的 对 话 框 中 根据 提示 操作 ， 阅 读 相 关 许 可 证 并 接受 ， 
NetBeans 会 自动 帮 我 们 下 载 并 安装 Maven 插 件 ， 结 束 之 后 会 提示 安装 完 
成 。 之 后 再 单 击 插 件 对 话 框 中 的 已 安装 标签 ， 就 能 看 到 已 经 激活 的 
Maven 插 件 。 


最 后 ， 为 了 确认 Maven 插 件 确实 已 经 正确 安装 了 ， 可 以 看 一 下 
NetBeans 是 否 已 经 拥有 创建 Maven 项 目的 相关 菜单 。 在 菜单 栏 中 选择 文 
件 ， 然 后 选择 新 建 项 目 ， 这 时 应 该 能 够 看 到 项 目 类 别 中 有 Maven 一 项 。 
选择 该 类 别 ， 右 边 会 相应 地 显示 Maven 项 目 和 基于 现 有 POM 的 Maven 项 
目 ， 如 图 2-13 所 示 。 





如 果 能 看 到 类 似 的 对 话 框 ， 说 明 NetBeans Maven 已 经 正确 安装 了 。 


Maven 项 目 
基于 现 有 POM 的 Maven 项 目 


使 用 Maven 本 身 的 Archetype 插件 创建 的 Waven2 项 目 模板 。 








2-13 ” NetBeans 中 创建 Maven 项 目 癌 导 


2.7 “Maven 安 装 最 佳 实践 





本 节 介 绍 一 些 在 安装 Maven 过 程 中 不 是 必须 的 ， 但 十 分 有 用 的 实 
践 。 


27.1 设置 MAVEN OPTS 环 境 变 量 


前 面 介绍 Maven 安 装 目录 时 我 们 了 解 到 ， 运 行 mvn 命 令 实际 上 是 执 
行 了 Java 人 命令， 既然 是 运行 Java， 那 么 运行 Java 命 令 可 用 的 参数 当然 也 
应 该 在 运行 mvn 命 令 时 可 用 。 这 个 时 候 ，MAVEN_OPTS 环 境 变量 就 能 
派 上 用 场 。 


通常 需要 设置 MAVEN_OPTS 的 值 为 -Xms128m-Xmx512m， 因 为 
Java 默 认 的 最 大 可 用 内 存 往往 不 能 够 满足 Maven 运 行 的 需要 ， 比 如 在 项 
目 较 大 时 ， 使 用 Maven 生 成 项 目 站 点 需要 占用 大 量 的 内 存 ， 如 果 没 有 该 
配置 ， 则 很 容易 得 到 java.lang.OutOfMemeoryError。 因 此 ， 一 开始 就 配 
置 该 变量 是 推荐 的 做 法 。 








关于 如 何 设置 环境 变量 ， 请 参考 前 面 设置 M2_HOME 环 境 变 量 的 做 
法 ， 尽 量 不 要 直接 修改 mvn.bat 或 者 mvn 这 两 个 Maven 执 行 脚本 文件 。 因 
为 如 果 修 改 了 脚本 文件 ， 升 级 Maven 时 就 不 得 不 再 次 修改 ， 一 来 麻烦 ， 
二 来 容易 忘记 。 同 理 ， 应 该 尽 可 能 地 不 去 修改 任何 Maven 安 装 目 录 下 的 
MF 0 


2.7.2 ”配置 用 户 范 围 settings.xml 


Maven 用 户 可 以 选择 配置 $M2_HOME/conf/settings.xml 或 者 
~/.m2/settings.xml。 前 者 是 全 局 范围 的 ， 整 台 机 器 上 的 所 有 用 户 都 会 直 
接受 到 该 配置 的 影响 ， 而 后 者 是 用 户 范 围 的 ， 只 有 当前 用 户 才 会 受到 该 
配置 的 影响 。 





推荐 使 用 用 户 范 围 的 settings.xml， 主 要 是 为 了 避免 无 意识 地 影响 到 
系统 中 的 其 他 用 户 。 如 果 有 切实 的 需求 ， 需 要 统一 系统 中 所 有 用 户 的 
settings.xml 配 置 ， 当 然 应 该 使 用 全 局 范围 的 settings.xml。 


除了 影响 范围 这 一 因 系 ， 配 置 用 户 范 围 settings.xml 文 件 还 便于 
Maven 升 级 。 直 接 修改 conf 目 录 下 的 settings.xml 会 导致 Maven 升 级 不 便 ， 
每 次 升级 到 新 版 本 的 Maven， 都 需要 复制 settings.xml 文 件 。 如 果 使 用 
~/.m2 目 录 下 的 settings.xml， 就 不 会 影响 到 Maven 安 闭 文 件 ， 升 级 时 就 不 


需要 触动 settings.xml 文 件 。 


2.7.3 7A\2E(8 IDEA tk HJ Maven 


无 论 Eclipse 还 是 NetBeans， 当 集成 Maven 时 ， 都 会 安装 上 一 个 内 扔 
的 Maven， 这 个 内 构 的 Maven 通 常会 比较 新 ， 但 不 一 定 很 稳定 ， 而 且 往 
往 也 会 和 在 命令 行使 用 的 Maven 不 是 同一 个 版 本 。 这 里 又 会 出 现 两 个 潜 
在 的 问题 ， 首 先 ， 较 新 版 本 的 Maven 存 在 很 多 不 稳定 因素 ， 容 易 造 成 一 
些 难 以 理解 的 问题 ; 其次， 除了 IDE， 也 经 常 还 会 使 用 命令 行 的 
Maven， 如 果 版 本 不 一 致 ， 容 易 造 成 构建 行为 的 不 一 致 ， 这 是 我 们 所 不 
希望 看 到 的 。 因 此 ， 应 该 在 IDE 中 配置 Maven 插 件 时 使 用 与 命令 行 一 致 
的 Maven 。 








在 m2eclipse 环 境 中 ， 单 击 菜 单 栏 中 的 Windows， 然 后 选择 
Preferences， 在 弹出 的 对 话 框 中 ， 展 开 左 边 的 Maven 项 ， 选 择 Installation 
子 项 ， 在 右边 的 面板 中 ， 能 够 看 到 有 一 个 默认 的 Embedded Maven 安 装 
被 选中 了 。 单 击 Add... 按 钮 ， 然 后 选择 Maven 安 装 目录 M2_HOME， 添 加 
完毕 之 后 选择 这 一 个 外 部 的 Maven， 如 图 2-14 所 示 。 





Installations 





Select the installation used to launch maven: 


Embedded (3.0-SNAPSHOT/0.10.0.20100209-08... 

Install/Update 回 Workspace (3.0) 
Java 回 External D:\bin\apache-maven-2.2.1 (2.2.1) 
Maven External D:\bin\apache-maven-3.0 (3.0) 

Archetypes 

Installations 

POM Editor 

Problem Reporting 


Note: Embedded runtime is always used for dependency resolution, but 
does not use global settings when it is used to launch Maven. To learn 
more, visit the maven web page. 


Global settings from installation directory (open file): 
Usage Data Collector - 
Validation D:\bin\apache-maven-3.0\conf\settings.xml 
XML 








@ 





图 2-14 在 Eclipse 中 使 用 外 部 Maven 


NetBeans Maven 插 件 默认 会 侦 测 PATH 环境 变量 ， 因 此 会 直接 使 用 
与 命令 行 一 致 的 Maven 环 境 。 依 次 单 击 沈 单 栏 中 的 工具 ~ 选项 ~ 其 他 
Maven 标 签 栏 ， 就 能 看 到 图 2-15 所 示 的 配置 。 


forte") 
vu 


编辑 器 ©) ”字体 和 颜色 T) 快捷 键 映 射 G) 








使 用 缺 省 Maven 版 本 : 2.2.1 (位 于 PATH 环境 变量 中 ) 


COO —— 
WSMitR A BRA RATS Ma THis T) 


《使 用 Maven SEAT HMRI > 


REIRE O: MRR 


在 本 地 索引 中 包含 快照 6) 





图 2-15 ”在 NetBeans 中 使 用 外 部 Maven 
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本 章 详细 介绍 了 在 各 种 操作 系统 平台 上 安装 Maven， 并 对 Maven 安 
装 目录 进行 了 深入 的 分 析 ， 在 命令 行 的 基础 上 ， 又 进一步 介绍 了 Maven 
与 主流 IDE Eclipse 及 NetBeans 的 集成 。 本 章 最 后 还 介绍 了 一 些 与 Maven 
安装 相关 的 最 佳 实践 。 下 一 章 会 创建 一 个 Hello World 项 目 ， 带 领 读者 配 
置 和 构建 Maven 项 目 。 














第 3 章 ”Maven 使 用 入 门 


编写 POM 

:编写 主 代 码 

-编写 测试 代码 

-打包 和 运行 

使 用 Archetype 生 成 项 目 骨 架 
-m2eclipse 人 简单 使 用 

-NetBeans Maven 插 件 简单 使 用 
小 结 


到 目前 为 止 ， 已 经 大 概 了 解 并 安装 好 了 Maven， 现 在 ， 我 们 开始 创 
建 一 个 最 简单 的 Hello World 项 目 。 如 果 你 是 初次 接触 Maven， 建 议 按照 
本 章 的 内 容 一 步 步 地 编写 代码 并 执行 ， 其 中 可 能 你 会 碰 到 一 些 概念 暂时 
难以 理解 ， 不 用 着 急 ， 记 下 这 些 疑 难点 ， 相 信 本 书 的 后 续 音 节 会 帮 你 逐 
一 解答 。 





3.1 编写 POM 


就 像 Make 的 Makefile、Ant 的 build.xml 一 样 ，Maven 项 目的 核心 是 
pom.xml. POM (Project Object Model， 项 目 对 象 模型 ) 定义 了 项 目的 
基本 信息 ， 用 于 描述 项 目 如 何 构建 ， 声 明 项 目 依赖 ， 等 等 。 现 在 移 为 
Hello World 项 目 编写 一 个 最 简单 的 pom.xml。 


首先 创建 一 个 名 为 hello-world 的 文件 夹 ， 打 开 该 文件 夹 ， 新 建 一 个 
名 为 pom.xml 的 文件 ， 输 入 其 内 容 ， 如 代码 清单 3-1 所 示 。 


代码 清单 3-1 Hello World 的 POM 


<?xml version = "1.0" encoding "UTF -8" 


<project xmin "http://maven. apache, org / "POMY 4.0. 
xmins :xsi = "htt p: // www, W3.0 2001 /XMLSchema-instance” 
xsi:schemaLocation = htt tp://maven. apache. org/POMA.0.0 
http: //maven. apache. org Sn=V ‘0.0. xsd" 


<modelVersion >4.0. 0 < ypa elVersic 
<groupId > Com. juvenxu.mvnbook < /groupid > 
<artifactid >hello-wor sa < yen tifactid> 


< version >1.0-SNAPSHOT < /version > 
<name >Maven Hello Wor 1 ai roject < /name > 
project > 


代码 的 第 一 行 是 XML 头 ， 指 定 了 该 xml 文 档 的 版 本 和 编码 方式 。 紧 
接着 是 project 元 素 ，project 是 所 有 pom.xml 的 根 元 素 ， 它 还 声明 了 一 些 
POM 相 关 的 命名 空间 及 xsd 元 素 ， 虽 然 这 些 属性 不 是 必须 的 ， 但 使 用 这 
些 属性 能 够 让 第 三 方 工 具 〈 如 IDE 中 的 XML 编辑 器 ) 帮助 我 们 快速 编辑 
POM. 


根 元 陛下 的 第 一 个 子 元 素 modelVersion 指 定 了 当前 POM 模 型 的 版 
本 ， 对 于 Maven 2 及 Maven 3 来 说 ， 它 只 能 是 4.0.0。 





这 段 代 码 中 最 重要 的 是 包含 groupId、artifactId 和 version 的 三 行 。 这 
三 个 元 素 定 义 了 一 个 项 目 基 本 的 坐标 ， 在 Maven 的 世界 ， 任 何 的 jar、 
pom 或 者 war 都 是 以 基于 这 些 基本 的 坐标 进行 区 分 的 。 





groupId 定 义 了 项 目 属 于 哪个 组 ， 这 个 组 往往 和 项 目 所 在 的 组 织 或 公 
司 存在 关联 。 璧 如 在 googlecode 上 建立 了 一 个 名 为 myapp 的 项 目 ， 那 么 
groupId 就 应 该 是 com.googlecode.myapp， 如 果 你 的 公司 是 mycom， 有 一 
个 项 目 为 myapp， 那 么 groupId 就 应 该 是 com.mycom.myapp。 本 书 中 所 有 
的 代码 都 基于 groupId com.juvenxu.mvnbook。 


artifactId 定 义 了 当前 Maven 项 目 在 组 中 唯一 的 ID， 我 们 为 这 个 Hello 

World 项 目 定义 artifactId 为 hello-world， 本 书 其 他 章节 代码 会 分 配 其 他 的 
artifactId。 而 在 前 面 的 groupId 为 com.googlecode.myapp 的 例子 中 ， 你 可 
能 会 为 不 同 的 子 项 目 《〈 模 块 ) 分 配 artifactId， 如 myapp-util、myapp- 


domain、myapp-web 等 。 





顾名思义 ，version 指 定 了 Hello World 项 目 当 前 的 版 本 一 一 1.0- 
SNAPSHOT。SNAPSHOT 意 为 快照 ， 说 明 该 项 目 还 处 于 开发 中 ， 是 不 
稳定 的 版 本 。 随 着 项 目的 发 展 ，version 会 不 断 更 新 ， 如 升级 为 1.0、1.1- 
SNAPSHOT、1.1、2.0 等 。6.5 节 会 详细 介绍 SNAPSHOT， 第 13 章 会 介绍 


如 何 使 用 Maven 管 理 项 目 版 本 的 升级 发 布 。 


最 后 一 个 name 元 素 声 明了 一 个 对 于 用 户 更 为 友好 的 项 目 名 称 ， 虽 然 
这 不 是 必须 的 ， 但 还 是 推荐 为 每 个 POM 声 明 name， 以 方便 信息 交流 。 





没有 任何 实际 的 Java 代 码 ， 我 们 就 能 够 定义 一 个 Maven 项 目的 
POM， 这 体现 了 Maven 的 一 大 优点 ， 它 能 让 项 目 对 象 模型 最 大 程度 地 与 
实际 代码 相 独 立 ， 我 们 可 以 称 之 为 解 厢 ， 或 者 正 交 性 。 这 在 很 大 程度 上 
避免 了 Java 代 码 和 POM 代 码 的 相互 影响 。 比 如 当 项 目 需要 升级 版 本 时 ， 
只 需要 修改 POM， 而 不 需要 更 改 Java 代 码 ;， 而 在 POM 稳 定之 后 ， 日 常 的 
Java 代 码 开发 工作 基本 不 涉及 POM 的 修改 。 








3.2 ”编写 主 代码 


项 目 主 代码 和 测试 代码 不 同 ， 项 目的 主 代码 会 被 打包 到 最 终 的 构件 
中 《如 jar) ， 而 测试 代码 只 在 运行 测试 时 用 到 ， 不 会 被 打包 。 默 认 情 况 
下 ，Maven 假 设 项 目 主 代 码 位 于 srcmainjava 目 录 ， 我 们 遵循 Maven 的 约 
定 ， 创 建 该 目录 ， 然 后 在 该 目录 下 创建 文件 
com/juvenxu/mvnbook/helloworld/HelloWorld.java， 其 内 容 如 代码 清单 3-2 
所 示 : 


代码 清单 3-2 Hello World 的 主 代 码 


package com. juvenxu. mvnbook. helloworld; 
public class HelloWorld 
public String sayHello() 


eturn "Hello Maven"; 
} 


public static void main (String[] args) 


System, out. print ( new HelloWorld().sayHello() ); 
} 


这 是 一 个 简单 的 Java 类 ， 它 有 一 个 sayHello O 方法 ， 返 回 一 个 
String。 同 时 这 个 类 还 带 有 一 个 main 方 法 ， 创 建 一 个 HelloWorld 实 例 ， 
调用 sayHello() 方法 ， 并 将 结果 输出 到 控制 合 。 








关于 该 Java 代 码 有 两 点 需要 注意 。 首 先 ， 在 绝 大 多 数 情 况 下 ， 应 该 


把 项 目 主 代码 放 到 src/main/java/ 目 录 下 (遵循 Maven 的 约定 )， 而 无 须 
额外 的 配置 ，Maven 会 自动 搜寻 该 目录 找到 项 目 主 代码 。 其 次 ， 该 Java 


类 的 包 名 是 com.juvenxu.mvnbook.helloworld， 这 与 之 前 在 POM 中 定义 的 





groupId 和 artifactId 相 吻合 。 一 般 来 说 ， 项 目 中 Java 类 的 包 都 应 该 基于 项 


目的 groupId 和 artifactId4， 这 样 更 加 清晰 ， 更 加 符合 逻辑 ， 也 方便 搜索 构 


件 或 者 Java 类 。 








代码 编写 完毕 后 ， 使 用 Maven 进 行 编译 ， 在 项 目 根 目录 下 运行 命令 


mvn clean compile 会 得 到 如 下 输出 : 


[INFO] Scanning for projects... 


[INFO] Building Maven Hello World Project 
[INFO] task-segment: [clean, compile] 


fexecution: default-clean}] 


sctory D:\code \hello-world\target 





resources :resources {execution: default-resources }] 


INFO] skip non existing resourceDirectory D: 





[INFO] [compiler:compile fexecution: default-compile}] 
[INFO] Compiling 1 source file to D: \code\hello-world\target \classes 





NFO] Total time: 1 second 


NFO] Finished at: Fri Oct 09 02:08:09 CST 2009 
[INFO] Final Memory: 9M/16M 


clean 告 诉 Maven 清 理 输 出 目录 target/，compile 告 诉 Maven 编 译 项 目 
主 代 码 ， 从 输出 中 看 到 Maven 首 先 执 行 了 clean: clean 任 务 ， 删 除 target/ 
目录 。 默 认 情 况 下 ，Maven 构 建 的 所 有 输出 都 在 target/ 目 录 中 ; 接着 执 


\ code \hello-world \src \main \re 


行 resources: resources 任 务 〈 未 定义 项 目 资源 ， 暂 且 略 过 ) ; 最 后 执行 
compiler: compile 任 务 ， 将 项 目 主 代码 编译 至 targetclasses 目 录 《〈 编 译 好 


的 类 为 com/juvenxu/mvnbook/helloworld/HelloWorld.Class) 。 


上 文 提 到 的 clean: clean, resources: resources 和 compiler: compile 
对 应 了 一 些 Maven 插 件 及 插件 目标 ， 比 如 clean: clean 是 clean 插 件 的 
clean 目 标 ，compiler: compile 是 compiler 插 件 的 compile 目 标 。 后 文 会 详 
细 讲 述 Maven 插 件 及 其 编写 方法 。 


人 至此，Maven 在 没有 任何 额外 的 配置 的 情况 下 惑 执行 了 项 目的 清理 
和 编译 任务 。 接 下 来 ， 编 写 一 些 单元 测试 代码 并 让 Maven 执 行 目 动 化 测 
试 。 


3.3 ”编写 测试 代码 


为 了 使 项 目 结构 保持 清晰 ， 主 代码 与 测试 代码 应 该 分 别 位 于 独立 的 
目录 中 。3.2 节 讲 过 Maven 项 目 中 默认 的 主 代 码 目录 是 src/main/java， 对 
应 地 ，Maven 项 目 中 默认 的 测试 代码 目录 是 src/tesyjava。 因 此 ， 在 编写 
测试 用 例 之 前 ， 应 当先 创建 该 目录 。 


在 Java 世 界 中 ， 由 Kent Beck 和 Erich Gamma 建 立 的 JUnit 是 事实 上 的 
单元 测试 标准 。 要 使 用 JUnit， 首 先 需要 为 Hello World 项 目 添 加 一 个 
JUnit 人 依赖， 修改 项 目的 POM 如 代码 清单 3-3 所 示 : 


代码 清单 3-3 ”为 Hello World 的 POM 添 加 依赖 


< ?Xml version = "1.0" encoding = "UTF -8"? 
<project xmins = "http://maven. apache. org/POMA. 
xmins :xsi = "http: //www.w3.org/2001 /XMLSchema-instance" 
xsi:schemaLocation = "http: //maven. apache. org/POMA.0.0 
http://maven. apache. org/maven-v4_0_0.xsd"> 
<modelVersion >4.0.0 < AnodelVersion > 
<groupId >com. juvenxu.mvnbook < /groupId > 
<artifactid >helloworld< /artifactId> 
<version >1.0-SNAPSHOT < /version > 
<name >Maven Hello World Project < /name > 
< dependenci 
< dependency > 
<groupId > junit </grouplId > 
<artifactId >junit < /artifactId> 
<version >4.7 < /version > 
< scope >test < /scope > 
< /Aependency > 
< /Aependencies > 
< foroject > 





代码 中 添加 了 dependencies 元 素 ， 该 元素 下 可 以 包含 多 个 dependency 
元 素 以 声明 项 目的 依赖 。 这 里 添加 了 一 个 依赖 
artifactId 是 junit，version 是 4.7。 前 面 提 到 groupId、artifactId 和 version 是 
任何 一 个 Maven 项 目 最 基本 的 坐标 ，JUnit 也 不 例外 ， 有 了 这 上 段 声明 ， 
Maven 就 能 够 自动 下 载 junit-4.7.jar。 也 许 你 会 问 ，Maven 从 哪里 下 载 这 
个 jar 昵 ? 在 Maven 之 前 ， 可 以 去 JUnit 的 官方 网 站 下 载 分 发 包 ， 有 了 
Maven， 它 会 自动 访问 中 央 仓 库 Chttp://repol.maven.org/maven2/) , F 
载 需 要 的 文件 。 读 者 也 可 以 自己 访问 该 仓库 ， 打 开路 径 juniUVjunit/4.7/， 
就 能 看 到 junit-4.7.pom 和 junit-4.7.jar。 第 6 章 会 详细 介绍 Maven 仓 库 及 中 
TREE. 








groupId 是 junit， 





上 述 POM 代 码 中 还 有 一 个 值 为 test 的 元 素 scope，scope 为 依赖 范围 ， 
知 依赖 范围 为 test 则 表示 该 依赖 只 对 测试 有 效 。 换 句 话 说， 测试 代码 中 
的 import JUnit 代 人 码 是 没有 问题 的 ， 但 是 如 果 在 主 代码 中 用 import JUnit 代 
码 ， 就 会 造成 编译 错误 。 如 果 不 声明 依赖 范围 ， 那 么 默认 值 就 是 
compile， 表 示 该 依赖 对 主 代 码 和 测试 代码 都 有 效 。 





配置 了 测试 依赖 ， 接 着 束 可 以 编写 测试 类 。 回 顾 一 下 前 面 的 
HelloWorld 类 ， 现 在 要 测试 该 类 的 sayHello() 方法 ， 检 查 其 返回 值 是 
否 为 “Hello Maven”。 在 src/test/java 目 录 下 创建 文件 ， 其 内 容 如 代码 清单 


3-4 所 示 : 


代码 清单 3-4 ”Hello World 的 测试 代码 


import static org, junit.Assert.assertEquals; 
import org. junit.Test 
public class HelloWorldTest 
@ Test 
public void testSayHello() 
HelloWorld hellowWorld = new HelloWorld(); 
String result = helloworld. sayHello(); 
assertEquals ( "Hello Maven", result ); 
y 


一 个 典型 的 单元 测试 包含 三 个 步骤 : DERMIKA ORT 
要 测试 的 行为 ，@ 检 查 结果 。 上 述 样 例 首先 初始 化 了 一 个 要 测试 的 
HelloWorld 实 例 ， 接 着 执行 该 实例 的 sayHello() 方法 并 保存 结果 到 
result 变 量 中 ， 最 后 使 用 JUnit 框 架 的 Assert 类 检查 结果 是 否 为 我 们 期 户 
的 “Hello Maven”。 在 JUnit 3 中 ， 约 定 所 有 需要 执行 测试 的 方法 都 以 test 
开头 ， 这 里 使 用 了 JUnit 4， 但 仍然 遵循 这 一 约定 。 在 JUnit 4 中 ， 需 要 执 
行 的 测试 方法 都 应 该 以 @Test 进 行 标注 。 





测试 用 例 编写 完毕 之 后 就 可 以 调用 Maven 执 行 测 试 。 运 行 mvn clean 


test: 


[INFO] Scanning for projects... 

[INFO] 

[INFO] Building Maven Hello World Project 

[INFO] task-segment: [clean, test] 

[INFO] 

[INFO] [clean:clean {execution: default-clean}] 

[INFO] Deleting directory D: \git—juven \mvnbook \code \hello-world\target 
[INFO] [resources:resources {execution: default-resources}] 


Downloading: http://repol.maven. org/maven2 /junit /junit /4.7 Aunit—-4.7.pom 
1K downloaded (junit-4.7.pom) 

[INFO] [compiler:compile {execution: default-compile}] 

[INFO] Compiling 1 source file to D: \code\hello-world\target \classes 
[INFO] [resources:testResources {execution: default-testResources}] 


Downloading: http: //repol.maven. org/maven2 /junit/junit/4.7 Aunit-4.7.jar 
226K downloaded (junit-4.7.jar) 
[INFO] [compiler:testCompile {execution: default-testCompile}}] 
[INFO] Compiling 1 source file to D: \code \hello-world\target \test-classes 
[INFO] 
[ERROR] BUILD FAILURE 
[INFO] 
[INFO] Compilation failure 
D: \ code \ hello-world \sre \ test \ java \ com \ juvenxu \ mvnbook \ helloworld \ Hel- 
loWorldTest.java:[8,5] -source 1.3 中 不 支持 注释 
(请 使 用 -source 5 或 更 高 版 本 以 启用 注释 ) 
@ Test 
[INFO] 


[INFO] For more information, run Maven with the-e switch 


不 圣 的 是 构建 失败 了 ， 先 耐心 分 析 一 下 这 段 输 出 “〈 为 了 本 书 的 简 
洁 ， 一 些 不 重要 的 信息 用 省 略 号 略 去 了 ) 。 命 令 行 输入 的 是 mvn clean 
test， 而 Maven 实 际 执行 的 可 不 止 这 两 个 任务 ， 还 有 clean: clean、 


resources: resources, compiler: compile. resources: testResources 以 及 





compiler: testCompile。 和 暂时 需要 了 解 的 是 ， 在 Maven 执 行 测试 〈test) 
之 前 ， 它 会 先 自 动 执行 项 目 主 资 源 处 理 、 主 代码 编译 、 测 试 资源 处 理 、 





测试 代码 编译 等 工作 ， 这 是 Maven 生 命 周 期 的 一 个 特性 。 本 书后 续 章 
会 详细 解释 Maven 的 生命 周期 。 


从 输出 中 还 看 到 : Maven 从 中 央 仓 库 下 载 了 junit-4.7.pom 和 junit- 
4.7.jar 这 两 个 文件 到 本 地 仓库 (~/.m2/repository) 中 ， 供 所 有 Maven 项 目 
使 用 。 


构建 在 执行 compiler: testCompile 任 务 的 时 候 失 败 了 ，Maven 输 出 提 
示 我 们 需要 使 用 -source 5 或 更 高 版 本 以 启动 注释 ， 也 就 是 前 面 提 到 的 
JUnit 4 的 @Test 注 解 。 这 是 Maven 初 学 者 常常 会 过 到 的 一 个 问题 。 由 于 
历史 原因 ，Maven 的 核心 插件 之 一 一 compiler 插 件 默认 只 支持 编译 Java 
1.3， 因 此 需要 配置 该 插件 使 其 文 持 Java5， 见 代码 清单 3-5。 





代码 清单 3-5 ”配置 maven-compiler-plugin 支 持 Java 5 





该 POM 省 略 了 除 插件 配置 以 外 的 其 他 部 分 。 我 们 暂且 不 去 关心 插件 





配置 的 细节 ， 只 需要 知道 compiler 插 件 支 持 Java 5 的 编译 。 现 在 再 执行 
mvn clean test， 输 出 如 下 : 


[INFO] [compiler:testCompile {execution: default-testCompile}] 
[INFO] Compiling 1 source file to D: \code\hello-world\target \test-classes 
NFO] [surefire:test {execution: default-—test }] 
[INFO] Surefire report directory: D: \code \hello-world\target \surefire-reports 
TESTS 
Running com. juvenxu.mvnbook. helloworld. HelloWorldTest 
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.055 sec 
Results : 
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 


INFO] BUILD SUCCESSFUL 
INFO] 





我 们 看 到 compiler: testCompile 任 务 执行 成 功 了 ， 测 试 代码 通过 编 
译 之 后 在 target/test-classes 下 生成 了 二 进 制 文件 ， 紧 接着 surefire: test 任 
务 运 行 测试 ，surefire 是 Maven 中 负责 执行 测试 的 插件 ， 这 里 它 运 行 测 试 
用 例 HelloWworldTest， 并 且 输 出 测试 报告 ， 显 示 一 共 运 行 了 多 少 测试 ， 
失败 了 多 少 ， 出 错 了 多 少 ， 跳 过 了 多 少 。 显 然 ， 我 们 的 测试 通过 了 。 


3.4 打包 和 运行 


将 项 目 进行 编译 、 测 试 之 后 ， 下 一 个 重要 步骤 就 是 打包 
(package) > Hello World 的 POM 中 没有 指定 打包 类 型 ， 使 用 默认 打包 
类 型 jar。 简 单 地 执行 命令 mvn clean package 进 行 打 包 ， 可 以 看 到 如 下 输 


£ run Fai re 0, Error ), Skipped: { 
INFO) [jar:jar {execution: default-jar}] 
[INFO] Building jar: D: \code \hello-world\target \hello-world-1.0-SNAPSHOT. jar 


类 似 地 ，Maven 会 在 打包 之 前 执行 编译 、 测 试 等 操作 。 这 里 看 到 
jar: jar 任 务 负 责 打 包 ， 实 际 上 就 是 jar 插 件 的 jar 目 标 将 项 目 主 代码 打包 
成 一 个 名 为 hello-world-1.0-SNAPSHOT.jar 的 文件 。 该 文件 也 位 于 target/ 
输出 目录 中 ， 它 是 根据 artifact-version.jar 规 则 进行 命名 的 ， 如 有 需要 ， 
还 可 以 使 用 finalName 来 自 定义 该 文件 的 名 称 ， 这 里 暂且 不 展开 ， 后 面 


会 详细 解释 。 

















至 此 ， 我 们 得 到 了 项 目的 输出 ， 如 果 有 需要 的 话 ， 就 可 以 复制 这 个 
jar 文 件 到 其 他 项 目的 Classpath 中 从 而 使 用 HelloWorld 类 。 但 是 ， 如 何 才 
能 让 其 他 的 Maven 项 目 直 接 引 用 这 个 jar 呢 ?还 需要 一 个 安装 的 步 又 ， 执 


行 mvn clean install: 





[INFO] Building 
[INFO] [instalil:insta 
[INFO] 1] i 
Users \] en T sa 
hello-world-1 = 
[INFO] 
INFO] BUILD SUCCE U 


在 打包 之 后 ， 又 执行 了 安装 任务 install: install。 从 输出 可 以 看 到 该 
任务 将 项 目 输出 的 jar 安 装 到 了 Maven 本 地 仓库 中 ， 可 以 打开 相应 的 文件 
夹 看 到 Hello World 项 目的 pom 和 jar。 之 前 讲述 JUnit 的 POM 及 jar 的 下 载 
的 时 候 ， 我 们 说 只 有 构件 被 下 载 到 本 地 仓库 后 ， 才 能 由 所 有 Maven 项 目 
使 用 ， 这 里 是 同样 的 道理 ， 只 有 将 Hello World 的 构件 安装 到 本 地 仓库 之 
后 ， 其 他 Maven 项 目 才能 使 用 它 。 


我 们 已 经 体验 了 Maven 最 主要 的 命令 : mvn clean compile, mvn 
clean test. mvn clean package, mvn clean install。 执 行 test 之 前 是 会 先 执 
行 compile 的 ， 执 行 package 之 前 是 会 完 执行 test 的 ， 而 类 似 地 ，install 之 
前 会 执行 package。 可 以 在 任何 一 个 Maven 项 目 中 执行 这 些 命令 ， 而 且 我 
们 已 经 清楚 它们 是 用 来 做 什么 的 。 





到 目前 为 止 ， 还 没有 运行 Hello Wodh H, PE% J HelloWorld% 
可 是 有 一 个 main 方 法 的 。 默 认 打包 生成 的 jar 是 不 能 够 直接 运行 的 ， 因 为 
带 有 main 方 法 的 类 信息 不 会 添加 到 manifest 中 《〈 打 开 jar 文 件 中 的 META- 
INFMANIFEST.ME 文 件 ， 将 无 法 看 到 Main-Class 一 行 ) 。 为 了 生成 可 执 


行 的 jar 文 件 ， 需 要 借助 maven-shade-plugin， 配 置 该 插件 如 下 : 


<executions > 


<phase >package < /phase > 


< /goals > 
<configuration > 
<transformers > 
<transformer implementation = "org, apache. maven. plugins, shade. resource 
ManifestResourceTransformer" > 
<mainClass >com. juvenxu. mvnbook. helloworld.HellioWorld < /mainClass > 
</transformer > 
< /transformers > 
< /configuration > 
< /execution > 
< /executions > 


< /plugin > 


plugin 元 素 在 POM 中 的 相对 位 置 应 该 在 <project><build><plugins> 下 
面 。 我 们 配置 了 mainClass 为 
com.juvenxu.mvnbook.helloworld.HelloWorld， 项 目 在 打包 时 会 将 该 信息 
放 到 MANIFEST 中 。 现 在 执行 mvn clean install， 待 构建 完成 之 后 打开 
target/ 目 录 ， 可 以 看 到 hello-world-1.0-SNAPSHOT.jar 和 original-hello- 
world-1.0-SNAPSHOT.jar， 前 者 是 带 有 Main-Class 信 息 的 可 运行 jar， 后 
者 是 原始 的 jar， 打 开 hello-world-1.0-SNAPSHOT.jar 的 META- 
INF/MANIFEST.MF， 可 以 看 到 它 包含 这 样 一 行 信 息 : 


Main-Class: com. juvenxu.mvnbook. helloworid. HelloWworld 





现在 ， 在 项 目 根 目录 中 执行 该 jar 文 件 : 


D: \code \hello-world >java-jar target \hello-world-1.0-SNAPSHOT. jar 


Hello Maven 


控制 台 输 出 为 Hello Maven， 这 正 是 我 们 所 期 望 的 。 


本 小 节 介 绍 了 Hello World 项 目 ， 侧 重点 是 Maven 而 非 Java 代 码 本 
身 ， 介 绍 了 POM、Maven 项 目 结构 以 及 如 何 编译 、 测 试 、 打 包 等 。 


3.5 “使 用 Archetype 生 成 项 目 骨架 


Hello World 项 目 中 有 一 些 Maven 的 约定 : 在 项 目的 根 目 录 中 放置 
pom.xml， 在 src/main/java 目 录 中 放置 项 目的 主 代码 ， 在 src/test/java 中 放 
置 项 目的 测试 代码 。 之 所 以 一 步 一 步 地 展示 这 些 步 骤 ， 是 为 了 能 让 可 能 
是 Maven 初 学 者 的 你 得 到 最 实际 的 感受 。 我 们 称 这 些 基 本 的 目录 结构 和 
pom.xml 文 件 内 容 称 为 项 目的 骨架 ， 当 第 一 次 创建 项 目 骨架 的 时 候 ， 你 

还 会 馈 有 兴趣 地 去 体会 这 些 默 认 约 定 背 后 的 思想 ， 第 二 次 ， 第 三 次 ， 你 
也 许 还 会 满意 自己 的 熟练 程度 ， 但 第 四 、 第 五 次 做 同样 的 事情 ， 你 可 能 
就 会 恼火 了 。 为 此 Maven 提 供 了 Archetype 以 帮助 我 们 快速 勾勒 出 项 目 骨 


口 
架 。 














不 是 以 Hello World 为 例 ， 我 们 使 用 maven archetype 来 创建 该 项 目的 
骨架 ， 离 开 当 前 的 Maven 项 目 目录 。 





如 果 是 Maven 3， 人 简单 地 运行 : 


mvn archetype :generate 





日 i=} >、 二 Ly A 
如 果 是 Maven 2， 最 好 运行 如 下 命令 : 
mvn org. apache. maven. plugins :maven-archetype-plugin:2.0-alpha-5 :generate 


很 多 资料 会 让 你 直接 使 用 更 为 简单 的 mvn archetype: generate ‘iz 


令 ， 但 在 Maven 2 中 这 是 不 安全 的 ， 因 为 该 命令 没有 指定 Archetype 插 件 
的 版 本 ， 于 是 Maven 会 自动 去 下 载 最 新 的 版 本 ， 进 而 可 能 得 到 不 稳定 的 
SNAPSHOT 版 本 ， 导 致 运行 失败 。 然 而 在 Maven 3 中 ， 即 使 用 户 没有 指 
定 版 本 ，Maven 也 只 会 解析 最 新 的 稳定 版 本 ， 因 此 这 是 安全 的 。 具 体内 
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我 们 实际 上 是 在 运行 插件 maven-archetype-plugin， 注 意 冒号 的 分 
隔 ， 其 格式 为 groupId: artifactId: version: goal, 
org.apache.maven.plugins 是 maven 官 方 插件 的 groupId，maven-archetype- 
plugin 是 Archetype 插 件 的 artifactId，2.0-alpha-5 是 目前 该 插件 最 新 的 稳定 
版 ，generate 是 要 使 用 的 插件 目标 。 


紧 接着 会 看 到 一 段 长 长 的 输出 ， 有 很 多 可 用 的 Archetype 供 选择 ， 包 
括 著 名 的 Appfuse 项 目的 Archetype、JPA 项 目的 Archetype 等 。 每 一 个 
Archetype 前 面 都 会 对 应 有 一 个 编号 ， 同 时 命令 行 会 提示 一 个 默认 的 编 
号 ， 其 对 应 的 Archetype 为 maven-archetype-quickstart， 直 接 回 车 以 选择 
该 Archetype， 紧 接着 Maven 会 提示 输入 要 创建 项 目的 groupId、 
artifactId、version 以 及 包 名 package。 如 下 输入 并 确认 : 


yk: : com. juvenxu.mvnbook. helloworld 





“onfi operties configuration: 
groug oI d: om. Juvenxu. mynbook 


aves rant Id: he [Lo 

version: 1.0-SNAPSHOT 

package: com. juvenxu.mvnbook. helloworld 
Y::Y 


Archetype 插 件 将 根据 我 们 提供 的 信息 创建 项 目 骨 架 。 在 当前 目录 
下 ，Archetype 插 件 会 创建 一 个 名 为 hello-world 〈 我 们 定义 的 artifactId ) 
的 子 目录 ， 从 中 可 以 看 到 项 目的 基本 结构 :基本 的 pom.xml 已 经 被 创 
建 ， 里 面包 含 了 必要 的 信息 以 及 一 个 junit 依 赖 ， 主 代码 目录 
src/main/java 已 经 被 创建 ， 在 该 目录 下 还 有 一 个 Java 类 
com.juvenxu.mvnbook.helloworld.App， 注 意 这 里 使 用 到 了 刚才 定义 的 包 
名 ， 而 这 个 类 也 仅仅 只 有 一 个 简单 的 输出 Hello World! 的 main 方 法 ; W 
试 代码 目录 src/test/java 也 被 创建 好 了 ， 并 且 包 含 了 一 个 测试 用 例 


com.juvenxu.mvnbook.helloworld.AppTest. 








Archetype 可 以 帮助 我 们 迅速 地 构建 起 项 目的 骨架 ， 在 前 面 的 例子 
中 ， 我 们 完全 可 以 在 Archetype 生 成 的 骨架 的 基础 上 开发 Hello World 项 目 
以 市 省 大 量 时 间 。 


此 外 ， 这 里 仅仅 是 看 到 了 一 个 最 简单 的 Archetype， 如 采 有 很 多 项 目 
拥有 类 似 的 自 定义 项 目 结构 以 及 配置 文件 ， 则 完全 可 以 一 劳 永 逸 地 开发 
自己 的 Archetype， 然 后 在 这 些 项 目 中 使 用 目 定 义 的 Archetype 来 快速 生 
成 项 目 骨 架 。 本 书后 面 的 章节 会 详细 阐述 如 何 开 发 Maven Archetype. 








3.6_m2eclipse 简 单 使 用 


介绍 前 面 Hello World 项 目的 时 候 ， 并 没有 涉及 IDE， 如 此 简单 的 一 
个 项 目 ， 使 用 最 简单 的 编辑 器 也 能 很 快 完 成 。 但 对 于 稍微 大 一 些 的 项 目 
来 说 ， 没 有 IDE 就 是 不 可 想象 的 。 本 节 介 绍 m2eclipse 的 基本 使 用 。 





3.6.1 导入 Maven 项 目 


第 2 章 介绍 了 如 何 安 装 m2eclipse， 现 在 ， 使 用 m2ecilpse 导 入 Hello 
World 项 目 。 选 择 菜 单项 File， 然 后 选择 Import， 我 们 会 看 到 一 个 Import 
对 话 框 。 在 该 对 话 框 中 选择 General 目录 下 的 Maven Projects， 然 后 单 击 
Next 按 钮 ， 就 会 出 现 Import Projects 对 话 框 。 在 该 对 话 框 中 单 击 Browse 按 
钮 选择 Hello World 的 根 目 录 〈( 即 包含 pom.xml 文 件 的 那个 目录 ) ， 这 时 
对 话 框 中 的 Projects: 部 分 就 会 显示 该 目录 包含 的 Maven 项 目 ， 如 图 3-1 
所 示 。 





Maven Projects 


Select Maven projects 


Root Directory: D:\git-juven\maven-book\code\ch-3 
Projects: 
/pom.xml - comjuvenxu.mvynbook:hello-world:1.0-SNAPSHOT;jar 


[E] Add project(s) to working set 


Working set: -| More... 
» Advanced 











图 3-1 在 Eclipse 中 导入 Maven 项 目 


单 击 Finish 按 钮 之 后 ，m2ecilpse 就 会 将 该 项 目 导入 到 当前 的 
workspace 中 ， 导 入 完成 之 后 ， 束 可 以 在 Package Explorer 视 图 中 看 到 图 3- 
2 所 示 的 项 目 结构 。 





a $y hello-world 
a CS src/main/java 
4 8 com juvenxu.mvnbook.helloworld 
» D HelloWorld java 
4 CS src/test/java 
4 8 comjuvenxu.mvnbook.helloworld 
b M HelloWorldTestjava 


> mÀ JRE System Library [J2SE-1.5] 
4 A Maven Dependencies 
> Qs junit-4,7 jar - D:\java\repository\junit\junit\4.7 
> @ sre 
> & target 
w pom.xml 





图 3-2 ”Eclipse 中 导入 的 Maven 项 目 结构 


我 们 看 到 主 代码 目录 src/main/java 和 测试 代码 目录 src/test/java 成 了 
Eclipse 中 的 资源 目录 ， 包 和 类 的 结构 也 十 分 清晰 。 当 然 pom.xml 永 远 在 
项 目的 根 目 录 下 ， 而 从 这 个 视图 中 甚至 还 能 看 到 项 目的 依赖 junit- 
4.7.jar， 其 实际 的 位 置 指 向 了 Maven 本 地 仓库 (这 里 自 定义 了 Maven 本 地 
仓库 地 址 为 D: Navarepository。 后 续 章 节 会 介绍 如 何 自 定 义 本 地 仓库 位 
置 ) 。 








3.6.2 ”创建 Maven 项 目 


创建 一 个 Maven 项 目 也 十 分 简单 ， 选 择 染 单项 File -, New ~ Other, 
在 弹出 的 对 话 框 中 选择 Maven 下 的 Maven Project， 然 后 单 击 Next 按 钮 ， 
在 弹出 的 New Maven Project 对 话 框 中 ， 使 用 默认 的 选项 〈 不 要 选择 
Create a simple project 选 项 ， 那 样 我 们 就 能 使 用 Maven Archetype) ， 单 
击 Next 按 钮 ， 此 时 m2eclipse 会 提示 我 们 选择 一 个 Archetype。 这 里 选择 
maven-archetype-quickstart， 再 单 击 Next 按 钮 。 由 于 m2eclipse 实 际 上 是 在 
使 用 maven-archetype-plugin 插 件 创 建 项 目 ， 因 此 这 个 步骤 与 上 一 节 使 用 
archetype 创 建 项 目 骨架 类 似 ， 输 入 groupId、artifactId、version、 


package (暂时 不 考虑 Properties) ， 如 图 3-3 所 示 。 


@ New Maven Project = 


New Maven project 
Specify Archetype parameters 





Group Id: comjuvenxu.mynbook 





Artifact Id: hello-world-m2e 





Version: 0.0.1-SNAPSHOT > 





Package: com,juvenxu,helloworldm2e 


Properties available from archetype: 


Name Value 








图 3-3 ”在 Eclipse 中 使 用 Archetype 创 建 项 目 


注意 ， 为 了 不 和 前 面 已 导入 的 Hello World 项 目 产 生 冲 突 和 混淆 ， 这 
里 使 用 不 同 的 artifacttd 和 package。 单 击 Finish 按 钮 ，Maven 项 目 就 创建 
完成 了 。 其 结构 与 前 一 个 已 导入 的 Hello World 项 目 基 本 一 致 。 


3.6.3 ”运行 mvn 命 令 


我 们 需要 在 命令 行 输入 如 mvn clean install 之 类 的 命令 来 执行 maven 
构建 ，m2eclipse 中 也 有 对 应 的 功能 。 在 Maven 项 目 或 者 pom.xml 上 碳 
击 ， 再 在 弹出 的 快捷 菜单 中 选择 Run As， 就 能 看 到 常见 的 Maven 命 令 ， 
如 图 3-4 所 示 。 


Assign Working Sets... 


Run As | S 1 Java Applet Alt+Shift+X A 
Debug As | 2 Java Application Alt+Shift+X, J 
Validate Ju 3 JUnit Test Alt+Shift+X, T 
Maven 4 Maven assembly:assembly 

Team 5 Maven build Alt+Shift+x, M 
Compare With | 6 Maven build... 

Restore from Local History... 7 Maven clean 

8 Maven generate-sources 

9 Maven install 


[INFO] Maven package 
[INFO] 

[INFO] Total time 
[INFO] Finished d ™2 Maven test 
{INFO} 
[INFO] 


Properties 


m2 Maven sourcejjar 


Run Configurations... 








图 3-4 在 Eclipse 中 运行 默认 mvn 命 令 


选择 想 要 执行 的 Maven 命 令 就 能 执行 相应 的 构建 ， 同 时 也 能 在 
Eclipse 的 console 中 看 到 构建 输出 。 这 里 常见 的 一 个 问题 是 ， 默 认 选 项 中 
没有 我 们 想 要 执行 的 Maven 命 令 怎么 办 ? 比如， 默认 带 有 mvn test, (AK 
们 想 执行 mvn clean test， 很 简单 ， 选 择 Maven build 以 自 定义 Maven 运 行 
命令 ， 在 弹出 对 话 框 的 Goals 一 项 中 输入 我 们 想 要 执行 的 命令 ， 如 clean 


test， 设 置 一 下 Name， 单 击 Run 即 可 。 并 且 ， 下 一 次 我 们 选择 Maven 

build， 或 者 使 用 快捷 键 “Alt+ShifttrXx，M” 快 速 执 行 Maven 构 建 的 时 候 ， 

上 次 的 配置 直接 就 能 在 历史 记录 中 找到 。 图 3-5 所 示 就 是 自 定 义 Maven 运 
行 命令 的 界面 。 











D:/git- 一 一 一 一 一 一 一 


Goals: clean test 
Profiles: 


Offline Update Snapshots 
Debug Output Skip Tests Non-recursive 
Resolve Workspace artifacts 


Parameter Name Value 


Maven Runtime: | 








图 3-5 ”在 Eclipse 中 自 定义 mvn 命 令 


3.7 NetBeans Maven 搬 件 简 单 使 用 


NetBeans 的 Maven 插 件 也 十 分 简单 易 用 ， 我 们 可 以 轻松 地 在 
NetBeans 中 导入 现 有 的 Maven 项 目 ， 或 者 使 用 Archetype 创 建 Maven 项 


目 ， 还 能 够 在 NetBeans 中 直接 运行 mvn 命 令 。 


3.7.1 打开 Maven 项 目 


与 其 说 打开 Maven 项 目 ， 不 如 称 之 为 导入 更 为 合适 ， 因 为 这 个 项 目 
不 需要 是 NetBeans 创 建 的 Maven 项 目 。 不 过 这 里 还 是 遵照 NetBeans 菜 单 
中 使 用 的 名 称 。 





选择 菜单 栏 中 的 文件 ， 然 后 选择 打开 项 目 ， 直 接 定 位 到 Hello World 
项 目的 根 目 录 ，NetBeans 会 十 分 智能 地 识别 出 Maven 项 目 ， 如 图 3-6 所 


ZN o 





查看 : ə DAIAPARI1 (D:) 





/ «BF pi library FAEERE): 


| G Ji maven-book Maven Hello World Project (jar) 


Eeit 
: g- $ code 回 作为 主 项 目 打 开 M) 
| | By ch-10 


[打开 所 需 的 项 目 R): 


d . settings 
E Jp) sre 


di target 





文件 名 : | D: \git-juven\maven-book\code\ch-3\hello-world 


文件 类 型 ; ”| 项 目 文件 来 














图 3-6 ”在 NetBeans 中 导入 Maven 项 目 


Maven 项 目的 图 标 有 别 于 一 般 的 文件 夹 ， 单 击 打开 项 目 后 ，Hello 
World 项 目 就 会 被 导入 到 NetBeans 中 ， 在 项 目 视 图 中 可 以 看 到 图 3-7 所 示 
的 项 目 结构 。 


NetBeans 中 项 目 主 代码 目录 的 名 称 为 源 包 ， 测 试 代码 目录 成 了 测试 
包 ， 编 译 范 围 依赖 为 库 ， 测 试 范 围 依赖 为 测试 库 。 这 里 也 能 看 到 
pom.xml, NetBeans ERER] IH 了 settings.xml。 


B-m Maven Hello World Project (jar) 
2 lb 源 包 
:i 加 = com. juvenxu. mvnbook. helloworld 
-加 HelloWorld java 
3 a mita 
| 日- com. Juvenxu. mvnbook. helloworld 
| HelloWorldlest. java 


-a F 

a ® Dink 

: 由 fas junit- -47.jer [test] 
ik: 项 目 文件 
-图 pom. xml 


settings. xml 





图 3-7 NetBeans 中 导入 的 Maven 项 目 结构 


3.7.2 ”创建 Maven 项 目 


在 NetBeans 中 创建 Maven 项 目 同样 十 分 轻松 。 在 菜单 栏 中 选择 文 

件 ， 然 后 选择 新 建 项 目 ， 在 弹出 的 对 话 框 中 ， 选 择 项 目 类 别 为 Maven， 
项 目 为 Maven 项 目 ， 单 击 “ 下 一 步 ” 按 钮 之 后 ， 对 话 框 会 提示 我 们 选择 
Maven 原 型 〈 即 Maven Archtype) 。 这 里 选择 Maven 快 速 启 动 原型 

(1.0) ， 即 前 文 提 到 的 maven-archetype-quickstart， 单 击 “ 下 一 步 ”按钮 
之 后 ， 输 入 项 目的 基本 信息 。 这 些 信息 在 之 前 讨论 Archetype 及 在 
m2eclipse 中 创建 Maven 项 目的 时 候 都 仔细 解释 过 ， 这 里 不 再 详 述 ， 如 图 
3-8 所 示 。 








ZR 

1. 选择 项 目 项 目 名 称 M): [Maven Hello World NetBeans 
2. Maven 原型 peee 
3. ”名称 和 位 置 项 目 位 置 L): |c \Users\Juven XIu\Documents\NetBeansProjects 








IMB ASE): [Documents \NetBeansProjects\Maven Hello World NetBeans | 





工件 Ia (a): [MavenHell o¥orldlfe tBeans 








组 Id G): ER mvnbook 








KEM: |1. o-smaPsHor 





aF): |eon. juvenxu. mynbook. mavenhelloworldnetbeans 


检查 附加 创建 属性 .. 





[ES 二 = 此 Ba | 下 -上 





图 3-8 在 NetBeans 中 使 用 Archetype 创 建 Maven 项 目 





单 击 “ 完 成 ”按钮 之 后 ， 一 个 新 的 Maven 项 目 就 创建 好 了 。 


3.7.3 ”运行 mvn 命 令 

NetBeans 在 默认 情况 下 提供 两 种 Maven 运 行 方式 ， 单 击 菜单 栏 中 的 
运行 ， 可 以 看 到 生成 项 目 和 清理 并 生成 项 目 两 个 选项 。 可 以 尝试 <“ 点击 
运行 Maven 构 建 >， 根 据 NetBeans 控 制 台 的 输出 ， 束 能 发 现 它 们 实际 上 对 


应 了 mvn install 和 mvn clean install 两 个 命令 。 





在 实际 开发 过 程 中 ， 我 们 往往 不 会 满足 于 这 两 种 简单 的 方式 。 比 
如 ， 有 时 候 我 们 只 想 执行 项 目的 测试 ， 而 不 需要 打包 ， 这 时 就 希望 能 够 
执行 mvn clean test 命 令 ， 所 笠 的 是 NetBeans Maven 插 件 完全 支持 自 定 义 
的 mvn 命 令 配置 。 





在 菜单 栏 中 选择 工具 ， 接 着 选择 选项 ， 在 对 话 框 的 最 上 面 一 栏 选择 
其 他 ， 在 下 面 选择 Maven 标 签 栏 。 在 这 里 可 以 对 NetBeans Maven 插 件 进 
行 全 局 的 配置 〈 还 记得 第 2 章 中 如 何 配置 NetBeans 使 用 外 部 Maven 
吗 ? ) 。 现 在 ， 选 择 倒 数 第 三 行 的 编辑 全 局 定制 目标 定义 …， 添 加 一 个 
名 为 Maven Test 的 操作 ， 执 行 目标 为 clean test， 暂 时 不 考虑 其 他 配置 选 
项 ， 如 图 3-9 所 示 。 





| cur 生成 器 | JavaScript | Java Mita Maven 版 本 控制 | 比较 | 任务 | 外 观 | 文件 | 问题 


(嵌入 的 Maven 版 本 : 3.0-SIAPSHDT) 





外 部 Maven Home 目录 : | | l 
ERRA Maven 版 本 : 2.2.1 (位 于 PATH HASH) 


全 局 执行 选项 0): | © 25 Maven 目标 定义 
Ean | fea): 
本 地 资源 库 1): 


项 目 打开 时 ; 
下 载 二 进 制 文件 0): 
检查 Javadoc: 
检查 源 (5): | 从 不 
请 注意 ， 将 其 中 任何 一 项 设置 为 “ 


执行 目标 E): pr test 
BME): | 
设置 属性 G) : 











编辑 全 局 定制 目标 定义 .…- 


索引 更 新 频率 O: -A-R 


在 本 地 索引 中 包 








图 3-9 ”在 NetBeans 中 自 定 义 mvn 命 令 


单 击 “ 缺 省 保存 该 配置 "， 在 Maven 项 目 上 右 击 ， 选 择 定制 ， 就 能 看 
到 刚才 配置 好 的 Maven 运 行 操作 。 选 择 Maven Test 之 后 ， 终 端 将 执行 
mvn clean test。 值 得 一 提 的 是 ， 也 可 以 在 项 目 上 右 击 ， 选 择 定制 ， 再 选 
择 目 标 ， 再 输入 想 要 执行 的 Maven 目 标 〈 如 clean package) ， 单 击 “ 确 
定 ” 按 钮 之 后 NetBeans 就 会 执行 相应 的 Maven 命 令 。 这 种 方式 十 分 便捷 ， 
但 这 是 临时 的 ， 该 配置 不 会 被 保存 ， 也 不 会 有 历史 记录 。 





38 2h 


本 章 以 尽 可 能 简单 且 详 细 的 方式 叙述 了 一 个 Hello World 项 目 ， 重 点 
解释 了 POM 的 基本 内 容 、Maven 项 目的 基本 结构 以 及 构建 项 目 基 本 的 
Maven 命 令 。 在 此 基础 上 ， 还 介绍 了 如 何 使 用 Archetype 快 速 创建 项 目 骨 


架 。 最 后 讲述 的 是 如 何在 Eclipse 和 NetBeans 中 导入 、 创 建 及 构建 Maven 
项 目 。 





前 几 章 已 经 大 概 解 释 了 Maven 是 什么 ， 并 且 介 绍 了 Maven 的 安装 和 
最 基本 的 使 用 。 从 本 章 开 始 ， 引 入 一 个 较为 真实 的 背景 案例 ， 以 演示 
Maven 使 用 的 真实 场景 。 由 于 本 书 的 主题 是 Maven， 我 们 不 想 让 项 目 变 
得 过 于 复杂 ， 或 者 涉及 过 多 的 技术 ， 因 此 该 案例 的 目的 还 是 帮助 我 们 理 
解 Maven 的 概念 ， 以 及 展示 大 部 分 Maven 项 目 需要 面 对 和 处 理 的 一 些 问 


题 。 
建议 读者 至 少 大 概 浏 览 本 间 内 容 ， 因 为 本 章 是 几乎 所 有 后 续 半 市 的 


背景 ， 了 解 了 背景 需求 ， 将 能 够 更 好 地 理解 相关 Maven 概 念 及 实践 的 曾 
R. 








4.1 简单 的 账户 注册 服务 

注册 互联 网 账户 是 日 常生 活 中 再 熟悉 不 过 的 一 件 事情 ， 作 为 一 个 用 
户 ， 注 册 账 户 的 时 候 往往 需要 做 以 下 事情 : 

.提供 一 个 未 被 使 用 的 账号 ID 

.提供 一 个 未 被 使 用 的 email 地 址 

.提供 一 个 任意 的 显示 名 称 

-设置 安全 密码 ， 并 重复 输入 以 确认 

输入 验证 码 


主 邮箱 查收 激活 链接 并 单 击 激活 账号 


K 


账号 的 ID 和 email 地 址 都 可 以 用 来 唯一 地 标识 东 个 账户 ， 而 显示 多 
称 则 用 来 显示 在 页 面 上 ， 方 便 浏览 。 注 册 的 时 候 用 户 还 需要 输入 两 次 密 
码 ， 以 确保 没有 输 错 。 系 统 则 需要 负责 检查 ID 和 email 的 唯一 性 ， 验 证 
两 次 输入 的 密码 是 否 一 致 。 验 证 码 是 由 系统 随机 生成 的 只 能 由 肉眼 识别 
其 内 容 的 图 片 ， 可 以 有 效 防止 机 器 恶意 批量 注册 ， 乔 输入 正确 的 验证 码 
信息 ， 系 统 则 会 进行 检查 ， 如 采 验 证 码 错误 ， 系 统 会 生成 并 返回 新 的 验 





证 码 。 一 旦 所 有 检查 都 没 问 题 了 ， 系 统 就 会 生成 一 个 激活 链接 ， 并 发 送 
到 用 户 的 邮箱 中 。 单 击 激 活 链 接 后 ， 账 户 束 被 激活 了 ， 这 时 账户 注册 完 
成 ， 用 户 可 以 进行 登录 。 


对 于 一 个 账户 注册 服务 ， 还 需要 考虑 一 些 安全 因素 。 例 如 ， 需 要 在 
服务 器 端 密 文 地 保存 密码 ， 检 查 密 码 的 强 弱 程 度 ， 更 进一步 则 需要 考虑 
验证 码 的 失效 时 间 ， 激 活 链接 的 失效 时 间 ， 等 等 。 


本 章 的 主要 目的 是 让 读者 清楚 地 了 解 这 个 背景 案例 ， 即 账户 注册 服 
务 ， 它 的 需求 是 什么 ， 基 于 这 样 的 一 个 需求 ， 我 们 会 怎样 设计 这 个 小 型 
的 系统 。 本 章 的 描述 几乎 不 会 涉及 Maven， 但 后 面 的 章节 在 讲述 各 种 
Maven 概 念 和 实践 的 时 候 ， 都 会 基于 这 一 实际 的 背景 案例 。 





4.2 ”需求 前 述 


了 解 账户 注册 服务 之 后 ， 下 面 从 软件 工程 的 视角 来 分 析 一 下 该 服务 


4.2.1 需求 用 例 


为 了 帮助 读者 详细 地 了 解 账户 注册 服务 的 需求 ， 这 里 正式 阐述 一 下 
账户 注册 服务 的 需求 用 例 ， 见 图 4-1。 


ERER: 
. 用户 访问 注册 页 面 
， 系 统 生成 验证 码 图 片 
. 用户 输 入 想 要 的 ID、Email 地 址 ， 想 要 的 显示 名 称 、 密 码 、 确 认 密 码 
， 用 户 输 入 验证 码 
， 用 户 提交 注册 请 求 
， 系 统 检 查验 证 码 
， 系 统 检 查 ID 是 否 已 经 被 注册 ，Email 是 否 已 经 被 注册 ， 密 码 和 确认 密码 是 否 一 致 
， 系 统 保存 未 激活 的 账户 信息 
， 系统 生成 激活 链接 ， 并 发 送 至 用 户 邮 箱 
10. 用 户 打开 邮箱 ， 访 问 激活 链 接 
11. 系 统 解析 激活 链接 ， 激 活 相 关 账 户 
12. 用 户 使 用 ID 和 密码 登录 


LRG: 
4a: 用 户 无 法 看 清 验证 码 ， 请 求 重新 生成 
1. 跳 转 到 步骤 2 
6a: 系统 检测 到 用 户 输入 的 验证 码 错误 
1 系统 提示 验证 码 错 误 
2. 跳 转 到 步 又 2 
7a: 系统 检测 到 ID 已 被 注册 ， 或 者 Email 已 被 注册 ， 或 者 密码 和 确认 密码 不 一 致 
1 系统 提示 相关 错误 信息 


2.，” 跳 转 到 步 又 2 





图 4-1 账户 注册 服务 需求 用 例 





该 注册 账户 用 例 包含 了 一 个 主要 场景 和 几 个 扩展 场景 。 该 用 例 的 角 
色 只 有 两 个 : 用 户 和 系统 。“ 主 要 场景 "描述 了 用 户 如 何 与 系统 一 步 一 步 
地 交互 ， 并 且 成 功 完成 注册 。*“ 扩 展 场景 ? 则 描述 了 一 些 中 途 发 生意 外 的 
情形 ， 比 如 用 户 输 错 验证 码 的 时 候 ， 系 统 就 需要 重新 生成 验证 码 ， 用 户 
也 需要 重新 输入 验证 码 。 





该 用 例 没有 涉及 非 功能 性 需求 (如 安全 性 ) ， 也 没有 详细 定义 用 户 
界面 ， 用 例 也 不 会 告诉 我 们 使 用 何 种 技术 。 关 于 该 服务 的 安全 性 ， 你 将 
会 看 到 一 些 实际 的 措施 ， 但 我 们 不 会 过 于 深入 ;， 关 于 用 户 界 面 ， 下 一 小 
节 会 给 出 一 个 界面 原型 ， 至 于 使 用 的 技术 ， 该 项 目 会 基于 大 家 所 熟知 的 
Spring 进 一 步 开发 。 








4.2.2 ”界面 原型 


里 然 根 据 图 4-1 中 的 文字 描述 ， 我 们 已 经 了 解 了 用 户 注 册 服 务 所 涉 
及 的 内 容 ， 但 图 4-2 所 示 的 注册 页 面 更 加 直观 。 图 4-2 清 楚 地 标示 了 注册 
账户 所 需要 填写 的 各 个 字段 ， 还 展示 了 一 个 验证 码 图 片 ， 旁 边 还 有 一 个 
简单 的 链接 用 来 获取 新 的 验证 码 图 片 。 





注册 新 账 己 


sr o 
Email: juven@changeme.com © 


nn © 


密码 


Eo 


看 不 清 ? 
摘 一 张 


确认 并 提交 





图 4-2 ”注册 账户 服务 界面 原型 


43.1 接口 


详细 了 解 了 这 个 简单 账户 注册 服务 的 需求 之 后 ， 就 能 勾勒 出 该 系统 
对 外 的 接口 。 从 需求 用 例 中 可 以 看 到 ， 系 统 对 外 的 接口 包括 生成 验证 码 
图 片 、 处 理 注册 请 求 、 激 活 账户 以 及 处 理 登 录 等 。 图 4-3 描 述 了 系统 的 
接口 。 


ca SignUpRequest 


AccountService id 
$$ email 
+generateCaptchakey() -displayName 
+generateCaptchalmage(captchakey: String) -password 
+signUp(signUpRequest: SignUpRequest) confirmPassword 
+activate(activationNumber: String) -captchakey 
-Hogintid; String, password: String) aptchavalue 





图 4-3 ”注册 账户 服务 系统 接口 


首先 需要 解释 的 是 generateCaptchaKey O 和 
generateCaptchalmage () 方法 ， 对 于 Captcha 的 简单 解释 就 是 验证 码 。 
每 个 Captcha 都 需要 有 一 个 key， 根 据 这 个 key， 系 统 才能 得 到 对 应 的 验证 
码 图 片 以 及 实际 值 。 因 此 ，generateCaptchaKey O 会 生成 一 个 Captcha 


key， 使 用 这 个 key 再 调用 generateImage O 方法 就 能 得 到 验证 码 图 片 。 
验证 人 码 的 key 以 及 验证 码 图 片 被 传送 到 客 尸 端 ， 用 户 通 过 肉眼 识别 再 输 
入 验证 码 的 值 ， 伴 随 着 key 再 传送 到 服务 器 端 验证 ， 服 务 器 端 就 可 以 通 
过 这 个 key 碍 到 正确 的 验证 码 值 ， 并 与 客户 端 传 过 来 的 值 进行 比 对 验 
iE. 





SignUpRequest 包 含 了 注册 用 户 所 需要 的 信息 ， 包 括 ID、email、 显 
示 名 称 、 密 码 、 确 认 密 码 等 。 这 些 信息 伴随 着 Captcha key 和 Captcha 
value 构 成 了 一 个 注册 请 求 ，signUp ©) 方法 接收 SignUpRequest 对 象 ， 
进行 验证 ， 如 果 验 证 正确 ， 则 创建 一 个 未 被 激活 的 账户 ， 同 时 在 后 台 也 
需要 发 送 一 封 带 有 激活 链接 的 邮件 。 





activate © 方法 接收 一 个 激活 码 ， 查 找 对 应 的 账户 进行 激活 。 


账户 激活 之 后 ， 用 户 可 以 使 用 login〈) 方法 进行 登录 。 


4.3.2 ”模块 结构 


定义 了 系统 核心 的 接口 之 后 ， 基 于 功能 分 割 和 方便 复 用 的 原则 ， 再 
对 系统 进一步 进行 划分 。 这 里 基于 包 名 划分 模块 ， 这 也 是 在 Java 中 比较 
常见 的 做 法 。 


也 许 你 会 觉得 为 如 此 简单 的 一 个 系统 或许 根本 就 不 该 称 之 为 系 
统 ) 划分 模块 有 点 小 题 大 做 了 ， 有 经 验 的 程序 员 根本 不 需要 多 少 设 计 就 
能 快速 完成 这 样 的 一 个 注册 功能 。 不 过 本 书 的 目的 不 在 这 个 功能 本 身 ， 
我 们 需要 一 个 像 模 像 样 的 、 有 很 多 模块 的 系统 来 演示 Maven 很 多 非常 酷 
的 特性 ， 同 时 ， 双 不 想 引 入 一 个 拥有 成 二 上 万 行 代码 的 过 于 庞大 的 系 
统 。 账 户 注 册 服 务 的 模块 划分 如 图 4-4 所 示 。 








| com,juvyenxu,mywnbook,account,persist 
com.juvenxu.mynbook, account. web 
' 
' 


y ae com, juvenxu.mynbook, account. captcha 
com.juvenxu.mynbook, account.service f--"“" 


tee 
Sa 


com, juvenxu, mynbook, account.email 


图 4-4 ”注册 账户 服务 包 图 
现在 逐个 解释 一 下 各 个 模块 〈 包 ) 的 作用 : 


‘com.juvenxu.mvnbook.account.service: 系统 的 核心 ， 它 封装 了 所 有 
下 层 细节 ， 对 外 暴露 简单 的 接口 。 这 实际 上 是 一 个 Facade 模 式 ， 了 解 设 
计 模 式 的 读者 应 该 能 马上 理解 。 








-com.juvenxu.mvnbook.account.web: 顾名思义 ， 该 模块 包含 所 有 与 
web 相 关 的 内 容 ， 包 括 可 能 的 JSP、Servlet、web.xml 等 ， 它 直接 依赖 于 


com.juvenxu.mvnbook.account.service 模 块 ， 使 用 其 提供 的 服务 。 





:com.juvenxu.mvnbook.account.persist: 处 理 账户 信息 的 持久 化 ， 包 
括 增 、 删 、 改 、 碍 等 ， 根 据 实现 ， 可 以 基于 数据 库 或 者 文件 。 








:com.juvenxu.mvnbook.account.captcha: 处 理 验 证 人 码 的 key 生 成 、 图 
片 生成 以 及 验证 等 ， 这 里 需要 第 三 方 的 类 库 来 帮助 实现 这 些 功能 。 








-com.juvenxu.mvnbook.account.email: 处 理 邮 件 服 务 的 配置 、 激 活 
邮件 的 编写 和 发 送 等 工作 。 


44 小结 


到 目前 为 止 ， 我们 已 经 了 解 了 账户 注册 服务 的 需求 、 大 概 的 界面 、 
简单 的 接口 设计 以 及 模块 的 职 贡 划分， 虽然 我 们 没有 实际 编写 代码 ， 但 
这 已 足够 支持 本 书后 续 章节 关于 Maven 概 念 和 实践 的 描述 。 在 下 面 的 章 
节 中 ， 这 个 简单 的 账户 注册 服务 将 得 以 一 步 步 地 实现 和 完善 ， 同 时 我 们 
也 将 看 到 Maven 如 何 与 实际 项 目 结合 并 发 挥 目 己 的 功效 。 











Bote ”坐标 和 依赖 


本 章 内 容 
. 何 为 Maven 坐 标 
.坐标 详解 


-account-email 


依赖 的 配置 


依赖 范围 


-传递 性 依赖 


-依赖 调解 


可 选 依赖 


最 佳 实践 


.小 结 


正如 第 1 章 所 述 ，Maven 的 一 大 功能 是 管理 项 目 依 赖 。 为 了 能 目 动 
化 地 解析 任何 一 个 Java 构 件 ，Maven 就 必须 将 它们 唯一 标识 ， 这 就 依赖 


管理 的 底层 基础 坐标 。 本 章 将 详细 分 析 Maven 坐 标的 作用 ， 解 释 其 
每 一 个 元 素 ; 在 此 基础 上 ， 再 介绍 如 何 配置 Maven， 以 及 相关 的 经 验 和 
技巧 ， 以 帮助 我 们 管理 项 目 依 赖 。 





5.1 何 为 Maven 坐 标 





关于 坐标 (Coordinate) ， 大 家 最 熟悉 的 定义 应 该 来 和 目 于 平面 几 
何 。 在 一 个 平面 坐标 系 中 ， 坐 标 Cx, y) 表示 该 平面 上 与 x 轴 距离 为 y， 
与 y 轴 距离 为 x 的 一 点 ， 任 何 一 个 坐标 都 能 够 唯一 标识 该 平面 中 的 一 点 。 


在 实际 生活 中 ， 我 们 也 可 以 将 地 址 看 成 是 一 种 坐标 。 省 、 市 、 区 、 
街道 等 一 系列 信息 同样 可 以 唯一 标识 城市 中 的 任 一 居住 地 址 和 工作 地 
址 。 邮 局 和 快递 公司 正 是 基于 这 样 一 种 坐标 进行 日 常 工作 的 。 





对 应 于 平面 中 的 点 和 城市 中 的 地 址 ，Maven 的 世界 中 拥有 数量 非常 
巨大 的 构件 ， 也 就 是 平时 用 的 一 些 jar、war 等 文件 。 在 Maven 为 这 些 构 
件 引 入 坐标 概念 之 前 ， 我 们 无 法 使 用 任何 一 种 方式 来 唯一 标识 所 有 这 些 
构件 。 因 此 ， 当 需要 用 到 Spring Framework 依 赖 的 时 候 ， 大 家 会 去 Spring 
Framework 网 站 寻找 ， 当 需要 用 到 log4j 依 赖 的 时 候 ， 大 家 又 会 去 Apache 
网 站 寻找 。 又 因为 各 个 项 目的 网 站 风格 迎 异 ， 大 量 的 时 间 花 费 在 了 搜 
索 、 浏 览 网 页 等 工作 上 面 。 没 有 统一 的 规范 、 统 一 的 法 则 ， 该 工作 就 无 
法 自动 化 。 重 复 地 搜索 、 浏 览 网 页 和 下 载 类 似 的 jar 文 件 ， 这 本 就 应 该 交 
给 机 器 来 做 。 而 机 器 工作 必须 基于 预定 义 的 规则 ，Maven 定 义 了 这 样 一 
组 规则 : 世界 上 任何 一 个 构件 都 可 以 使 用 Maven 坐 标 唯一 标识 ，Maven 
坐标 的 元 素 包 括 groupId、artifactId4、version、packaging、classifier。 现 
在 ， 只 要 我 们 提供 正确 的 坐标 元 素 ，Maven 就 能 找到 对 应 的 构件 。 比 如 











说 ， 当 需要 使 用 Java5 平 台 上 TestNG 的 5.8 版 本 时 ， 就 告诉 

Maven: “groupld=org.testng; artifactId=testng; version=5.8; 
classifier=jdk15”，Maven 就 会 从 仓库 中 寻找 相应 的 构件 供 我 们 使 用 。 也 
许 你 会 奇怪 ,“Maven 是 从 哪里 下 载 构件 的 呢 ? ”答案 其 实 很 简单 ， 
Maven 内 置 了 一 个 中 央 仓 库 的 地 址 Chttp://repol.maven.org/maven2) , 
该 中 央 仓 库 包 含 了 世界 上 大 部 分 流行 的 开源 项 目 构 件 ，Maven 会 在 需要 
的 时 候 去 那里 下 载 。 


在 我 们 开发 上 自己 项 目的 时 候 ， 也 需要 为 其 定义 适当 的 坐标 ， 这 是 
Maven 强 制 要 求 的 。 在 这 个 基础 上 ， 其 他 Maven 项 目 才 能 引用 该 项 目 生 
成 的 构件 ， 见 图 5-1。 





log4j:log4j:1.2.15 


org,springframework:spring-core:2.5 





图 5-1 坐标 为 构件 引入 秩序 


5.2 ”坐标 详解 


Maven 坐 标 为 各 种 构件 引入 了 秩序 ， 任 何 一 个 构件 都 必须 明确 定义 
自己 的 坐标 ， 而 一 组 Maven 坐 标 是 通过 一 些 元 素 定 义 的 ， 它 们 是 
groupId、artifactId、version、packaging、classifier。 先 看 一 组 坐标 定 
X, WF: 


<artifactId >nexus-indexer < /artifactId> 


<version >2.0.0 < Aversion > 
< packaging > jar < /packaging > 


这 是 nexus-indexer 的 坐标 定义 ，nexus-indexer 是 一 个 对 Maven 仓 库 编 
纂 索引 并 提供 搜索 功能 的 类 库 ， 它 是 Nexus 项 目的 一 个 子 模块 。 后 面 会 
详细 介绍 Nexus。 上 述 代码 卢 段 中 ， 其 坐标 分 别 为 groupId: 
org.Sonatype.nexus、artifactId: nexus-indexer, version: 2.0.0、 


packaging: jar， 没 有 classifier。 下 面 详 细 解 释 一 下 各 个 坐标 元 素 : 





‘groupld: 定义 当前 Maven 项 目 隶 属 的 实际 项 目 。 首 先 ，Maven 项 目 
和 实际 项 目 不 一 定 是 一 对 一 的 关系 。 比 如 SpringFramework 这 一 实际 项 
目 ， 其 对 应 的 Maven 项 目 会 有 很 多 ， 如 spring-core、spring-context 等 。 这 
是 由 于 Maven 中 模块 的 概念 ， 因 此 ， 一 个 实际 项 目 往 往 会 被 划分 成 很 多 
模块 。 其 次 ，groupId 不 应 该 对 应 项 目 隶 属 的 组 织 或 公司 。 原 因 很 简单 ， 
一 个 组 织 下 会 有 很 多 实际 项 目 ， 如 果 groupId 只 定义 到 组 织 级 别 ， 而 后 面 

















我 们 会 看 到 ，artifactId 只 能 定义 Maven 项 目 〈 模 块 ) ， 那 么 实际 项 目 这 
个 层 将 难以 定义 。 最 后 ，groupId 的 表示 方式 与 Java 包 名 的 表示 方式 类 
似 ， 通 常 与 域名 反问 一 一 对 应 。 上 例 中 ，groupId 为 org.sonatype.nexus， 


org.sonatype 表 示 Sonatype 公 司 建立 的 一 个 非 鳃 利 性 组 织 ，nexus 表 示 








vy 


Nexus 这 一 实际 项 目 ， 该 groupId 与 域名 nexus.sonatype.org 对 应 。 


“artifactId: 该 元 素 定 义 实 际 项 目 中 的 一 个 Maven 项 目 《〈 模 块 ) HE 
荐 的 做 法 是 使 用 实际 项 目 名 称 作 为 artifactId 的 前 级 。 比 如 上 例 中 的 
artifactId 是 nexus-indexer， 使 用 了 实际 项 目 名 nexus 作 为 前 级 ， 这 样 做 的 
好 处 是 方便 寻找 实际 构件 。 在 默认 情况 下 ，Maven 生 成 的 构件 ， 其 文件 
名 会 以 artifactId 作 为 开头 ， 如 nexus-indexer-2.0.0.jar， 使 用 实际 项 目 名称 
作为 前 缀 之 后 ， 就 能 方便 从 一 个 jib 文 件 夹 中 找到 某 个 项 目的 一 组 构件 。 
考虑 有 5 个 项 目 ， 每 个 项 目 都 有 一 个 core 模 块 ， 如 果 没 有 前 级 ， 我 们 会 
看 到 很 多 core-1.2.jar 这 样 的 文件 ， 加 上 实际 项 目 名 前 级 之 后 ， 便 能 很 容 


易 区 分 foo-core-1.2.jar、bar-core-1.2.jar...... 








‘version: 该 元 素 定 义 Maven 项 目 当 前 所 处 的 版 本 ， 如 上 例 中 nexus- 
indexer 的 版 本 是 2.0.0。 需 要 注意 的 是 ，Maven 定 义 了 一 套 完 成 的 版 本 规 
范 ， 以 及 快照 (SNAPSHOT) 的 概念 。 第 13 章 会 详细 讨论 版 本 管理 内 


JS 


容 。 


‘packaging: 该 元 素 定 义 Maven 项 目的 打包 方式 。 首 先 ， 打 包 方 式 
通常 与 所 生成 构件 的 文件 扩展 名 对 应 ， 如 上 例 中 packaging 为 jar， 最 终 的 





文件 名 为 nexus-indexer-2.0.0.jar， 而 使 用 war 打 包 方 式 的 Maven 项 目 ， 最 
终生 成 的 构件 会 有 一 个 .war 文 件 ， 不 过 这 不 是 绝对 的 。 其 次 ， 打 包 方 式 
会 影响 到 构建 的 生命 周期 ， 比 如 jar 打 包 和 war 打 包 会 使 用 不 同 的 命令 。 
最 后 ， 当 不 定义 packaging 的 时 候 ，Maven 会 使 用 默认 值 jar。 














‘classifier: 该 元 素 用 来 帮助 定义 构建 输出 的 一 些 附属 构件 。 附 属 构 
件 与 主 构件 对 应 ， 如 上 例 中 的 主 构件 是 nexus-indexer-2.0.0.jar， 该 项 目 
可 能 还 会 通过 使 用 一 些 插件 生成 如 nexus-indexer-2.0.0-javadoc.jar、 
nexus-indexer-2.0.0-sources.jar 这 样 一 些 附 属 构 件 ， 其 包含 了 Java 文 档 和 
源 代码 。 这 时 候 ，javadoc 和 sources 就 是 这 两 个 附属 构件 的 classifier。 这 
样 ， 附 属 构件 也 就 拥有 了 自己 唯一 的 坐标 。 还 有 一 个 关于 classifier 的 典 
型 例子 是 TestNG，TestNG 的 主 构件 是 基于 Java 1.4 平 台 的 ， 而 它 又 提供 
了 一 个 classifier 为 jdk5 的 附属 构件 。 注 意 ， 不 能 直接 定义 项 目的 
classifier， 因 为 附属 构件 不 是 项 目 直接 默认 生成 的 ， 而 是 由 附加 的 插件 
帮助 生成 。 

















上 述 5 个 元 素 中 ，groupId、artifactId、version 是 必须 定义 的 ， 
packaging 是 可 选 的 〈 默 认为 jar) ， 而 classifier 是 不 能 直接 定义 的 。 





同时 ， 项 目 构件 的 文件 名 是 与 坐标 相对 应 的 ， 一 般 的 规则 为 
artifactId-version [-classifier] .packaging, [-classifier] 表示 可 选 。 比 如 
上 例 nexus-indexer 的 主 构件 为 nexus-indexer-2.0.0.jar， 附 属 构件 有 nexus- 
indexer-2.0.0-javadoc.jar。 这 里 还 要 强调 的 一 点 是 ，packaging 并 非 一 定 与 





构件 扩展 名 对 应 ， 比 如 packaging 为 maven-plugin 的 构件 扩展 名 为 jar。 





此 外 ，Maven 仓 库 的 布局 也 是 基于 Maven 坐 标 ， 这 一 点 会 在 介绍 
Maven 仓 库 的 时 候 详 细 解 释 。 

理解 清楚 城市 中 地 址 的 定义 方式 后 ， 邮 北 员 就 能 够 开始 工作 了 ; 同 
样 地 ， 理 解 清楚 Maven 坐 标 之 后 ， 我 们 就 能 开始 讨论 Maven 的 依赖 管理 
Wee 


5.3 account-email 


在 详细 讨论 Maven 依 赖 之 前 ， 先 稍微 回顾 一 下 上 一 章 提 到 的 背景 案 
例 。 和 案例 中 有 一 个 email 模 块 负责 发 送 账户 激活 的 电子 邮件 ， 本 节 就 详 
细 曾 述 该 模块 的 实现 ， 包 括 POM 配 置 、 主 代码 和 测试 代码 。 由 于 该 背景 
案例 的 实现 是 基于 Spring Framework， 因 此 还 会 涉及 相关 的 Spring 配 置 。 





5.3.1 _ account-email 的 POM 


首先 看 一 下 该 模块 的 POM， 见 代码 清单 5-1。 
代码 清单 5-1 account-email 的 POM 


<project xmins = "http://maven.apache.org/POM/A.0.0" 
xmlns:xsi =http://www.w3.org/2001 /XMLSchema-instance 
xsi:schemaLocation = "http: //maven. apache. org/POM/4.0.0 
http: //maven. apache. org /maven-v4_0_0.xsd"> 


<modelVersion >4.0.0 < ArmodelVersion > 

<groupid >com. juvenxu. mvnbook. account < /groupId > 
<artifactId >account-email < /artifactId> 

<name >Account Email < /name > 

<version >1.0.0-SNAPSHOT < /version > 


< dependencies > 

< dependency > 
<grouplId >org. springframework < /groupId > 
<artifactId >spring-core < /artifactId> 
<version >2.5.6 < /version > 

< /dependency > 

< dependency > 
<groupId >org. springframework < /groupid > 
<artifactId>spring-beans < /artifactId> 
<version >2.5.6 < /version > 

< /dependency > 

< dependency > 
<groupid >org.springframework < /groupId > 
<artifactId >spring-context < /artifactid> 
<version >2.5.6 < /version > 

< /dependency > 

< dependency > 
<groupid > org. springframework < /groupId > 
<artifactId >spring-context-support < /artifactId> 
<version >2.5.6</version > 

< /dependency > 

< dependency > 
<grouplId > javax.mail < /groupld > 
<artifactIid>mail < /artifactId> 
<version >1.4.1< /version> 

< /dependency > 

< dependency > 
<groupId > junit < /groupId > 
<artifactid>junit < /artifactId> 
<version >4.7 < /version > 
<scope >test < /scope > 

< /dependency > 

< dependency > 
<groupId >com. icegreen < /groupId > 
<artifactiId >greenmail < /artifactid> 
<version >1.3.1b</version > 
< scope >test < /scope > 

< /dependency > 

< /dependencies > 


<build> 
<plugins > 
<plugin> 
<groupid >org, apache. maven. plugins < /groupid > 
<artifactId >maven-compiler-plugin< /artifactId> 
<configuration > 
<source >1.5 < /source > 
<target >1.5 </target> 
< /configuration > 


先 观 察 该 项 目 模块 的 坐标 ，groupld: 
com.juvenxu.mvnbook.account; artifactId: account-email; version: 1.0.0- 
SNAPSHOT。 由 于 该 模块 属于 账户 注册 服务 项 目的 一 部 分 ， 因 此 ， 其 
groupId 对 应 了 account 项 目 。 紧 接着 ， 该 模块 的 artifactId 仍 然 以 account 作 
为 前 缀 ， 以 方便 区 分 其 他 项 目的 构建 。 最 后 ，1.0.0-SNAPSHOT 表 示 该 
版 本 处 于 开发 中 ， 还 不 稳定 。 


再 看 dependencies 元 素 ， 其 包含 了 多 个 dependency 子 元 素 ， 这 是 
POM 中 定义 项 目 依 赖 的 位 置 。 以 第 一 个 依赖 为 例 ， 其 groupId: 
artifactId: version 为 org.Springframework: spring-core: 2.5.6， 这 便 是 依 
赖 的 坐标 ， 任 何 一 个 Maven 项 目 都 需要 定义 自己 的 坐标 ， 当 这 个 Maven 
项 目 成 为 其 他 Maven 项 目的 依赖 的 时 候 ， 这 组 坐标 就 体现 了 其 价值 。 本 
例 中 的 spring-core， 以 及 后 面 的 spring-beans、spring-context、spring- 
context-support 是 Spring Framework 实 现 依赖 注入 等 功能 必要 的 构件 ， 由 
于 本 书 的 关注 点 在 于 Maven， 只 会 涉及 简单 的 Spring Framework 的 使 
用 ， 不 会 详细 解释 Spring Framework 的 用 法 ， 如 果 读 者 有 不 清楚 的 地 
方 ， 请 参阅 Spring Framework 相 关 的 文档 。 


在 spring-context-support 之 后 ， 有 一 个 依赖 为 javax.mail: mail: 


1.4.1， 这 是 实现 发 送 必须 的 类 库 。 


紧 接 着 的 依赖 为 junit: junit: 4.7，JUnit 是 Java 社 区 事实 上 的 单元 测 
试 标准 ， 详 细 信 息 请 参阅 http:/www.junit.org/， 这 个 依赖 特殊 的 地 方 在 
于 一 个 值 为 test 的 scope 子 元 素 ，scope 用 来 定义 依赖 范围 。 这 里 读者 暂时 
只 需要 了 解 当 依赖 范围 是 test 的 时 候 ， 该 依赖 只 会 被 加 入 到 测试 代码 的 
classpath 中 。 也 就 是 说 ， 对 于 项 目 主 代 码 ， 该 依赖 是 没有 任何 作用 的 。 
JUnit 是 单元 测试 框架 ， 只 有 在 测试 的 时 候 才 需要 ， 因 此 使 用 该 依赖 范 
围 。 





随后 的 依赖 是 com.icegreen: greenmail: 1.3.1b， 其 依赖 范围 同样 为 
test。 这 时 也 许 你 已 经 猜 到， 该 依赖 同样 只 服务 于 测试 目的 ，GreenMail 
是 开源 的 邮件 服务 测试 套件 ，account-email 模 块 使 用 该 套件 来 测试 邮件 
的 发 送 。 关 于 GreenMail 的 详细 信息 可 访问 


http://www.icegreen.com/greenmail/。 


最 后 ，POM 中 有 一 段 关 于 maven-compiler-plugin 的 配置 ， 其 目的 是 
开启 Java 5 的 支持 ， 第 3 章 已 经 对 该 配置 做 过 解释 ， 这 里 不 再 袭 述 


5.3.2 ”account-email 的 主 代码 


account-email 项 目 Java 主 代码 位 于 src/main/java， 资 源 文 件 ( 非 


Java) 位 于 src/main/resources 月 录 下 。 
account-email 只 有 一 个 很 简单 的 接口 ， 见 代码 清单 5-2。 
代码 清单 5-2 AccountEmailService.java 


package com. juvenxu.mvnbook. account. email; 


public interface AccountEmailService 


void sendMail ( String to, String subject, String htmlText ) 
throws AccountEmailException; 


sendMail O 方法 用 来 发 送 html 格 式 的 邮件 ，to 为 接收 地 址 ，subject 
为 邮件 主题 ，htmlText 为 邮件 内 容 ， 如 采 发 送 邮 件 出 错 ， 则 抛 出 


AccountEmailException 异 和 常 。 
对 应 于 该 接口 的 实现 见 代码 清单 5-3。 


代码 清单 5-3 AccountEmailServiceImpl.java 


package com. juvenxu.mvnbook. account. email; 


import javax.mail.MessagingException; 
import javax.mail, internet.MimeMessage; 


import org. springframework.mail.javamail.JavaMailSender; 
import org. springframework. mail. javamail.MimeMessageHelper; 


public class AccountEmailServicelImpl 
implements AccountEmailService 

{ 
private JavaMailSender javaMailSender; 


private String systemEmail; 


public void sendMail ( String to, String subject, String htmlText ) 
throws AccountEmailException 


{ 
try 
{ 
MimeMessage msg = javaMailSender. createMimeMessage (); 
MimeMessageHelper msgHelper = new MimeMessageHelper (msg ); 
msqHelper.setFrom( systemEmail ); 
msgHelper. setTo( to ); 
msgHelper. setSubject ( subject }; 
msgHelper.setText ( htmlText, true }; 
javaMailSender. send( msg ); 
} 
catch ( MessagingException e ) 
{ 
throw new AccountEmailException( "Faild to send mail. ", e); 
} 
} 


public JavaMailSender getJavaMailSender () 
{ 


首先 ， 访 AccountEmailServiceImpl 类 有 一 个 私有 字段 
javaMailSender， 该 字段 的 类 型 
org.Springframework.mail.javamail.JavaMailSender 是 来 自 于 Spring 
Framework 的 帮助 简化 邮件 发 送 的 工具 类 库 ， 对 应 于 该 字段 有 一 组 
getter () 和 setter《) 方法 ， 它 们 用 来 帮助 实现 依赖 注入 。 本 节 随 后 会 
讲述 Spring Framework 依 赖 注 入 相关 的 配置 。 








在 sendMail ©) 的 方法 实现 中 ， 首 先 使 用 javaMailSender 创 建 一 个 
MimeMessage， 该 msg 对 应 了 将 要 发 送 的 邮件 。 接 着 使 用 
MimeMessageHelper 帮 助 设 置 该 邮件 的 发 送 地 址 、 收 件 地 址 、 主 题 以 及 
内 容 ，msgHelper.setText (htmlText, true) 中 的 true 表 示 邮 件 的 内 容 为 
html 格 式 。 最 后 ， 使 用 javaMailSender 发 送 该 邮件 ， 如 果 发 送出 错 ， 则 捕 
捉 MessageException 异 常 ， 包 装 后 再 抛 出 该 模块 自己 定义 的 


AccountEmailException 异 和 © 


这 段 Java 代 码 中 没有 邮件 服务 器 配置 信息 ， 这 得 益 于 Spring 
Framework 的 依赖 注入 ， 这 些 配 置 都 通过 外 部 的 配置 注入 到 了 
javaMailSender 中 ， 相 关 配 置信 息 都 在 src/main/resources/account- 
email.xml 这 个 配置 文件 中 ， 见 代码 清单 5-4。 





代码 清单 5-4 account-email.xml 


<?xml version = "1.0" encoding = "UTF-8"?> 

<beans xmins = "http://www. springframework. org/schema/beans" 
xmins:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xsi:schemaLocation = "http://www. springframework. org /schema /beans 

http: //www. springframework. org/ schema /beans /spring-beans-2.5.xsd"> 


<bean id ="propertyConfigurer" 
class = "org. springframework. beans. factory.config. PropertyPlaceholder — 
Configurer" > 
<property name = "location" value = "classpath:service. properties" /> 
< /bean > 


<bean id = "javaMailSender" class = "org. springframework. mail. javamail.JavaMail- 
SenderImp1l" > 
<property name = "protocol" value =" $ {email.protocol}" /> 
<property name = "host" value =" $ {email.host}" /> 


<property name = "port" value =" $ {email.port}" /> 
<property name = "username" value =" $ {email.username}" /> 


<property name = "password" value =" $ {email.password}" / 
<property name = "javaMailProperties"” > 
<props > 


<prop key = "mail. $ femail.protocol}.auth"> $ femail.auth}< /prop > 
< /props > 
< / property > 
< / pean > 


<bean id = “accountEmailService" 
class = "com. juvenxu. mvnbook. account. email. AccountEmailServiceImpl" > 
<property name = "javaMailSender" ref ="javaMailSender" /> 
<property name = "systemEmail" value =" $ {email.systemEmail}" /> 
< /bean > 
< /beans > 


Spring Framework 会 使 用 该 XML 配置 创建 ApplicationContext， 以 实 
现 依赖 注入 。 访 配置 文件 定义 了 一 些 bean， 基 本 对 应 了 Java 程 序 中 的 对 


象 。 首 先 解释 下 id 为 propertyConfigurer 的 bean， 其 实现 为 
org.Springframework.beans.factory.config.PropertyPlaceholderConfigurer， 
这 是 Spring Framework 中 用 来 帮助 载 入 properties 文 件 的 组 件 。 这 里 定义 
location 的 值 为 classpath: account-email.properties， 表 示 从 classpath 的 根 
路 径 下载 入 名 为 accountremail.properties 文 件 中 的 属性 。 


接着 定义 id 为 javaMailSender 的 bean， 其 实现 为 
org.springframework.mail.javamail.JavaMail-SenderImpl， 这 里 需要 定义 邮 
件 服务 器 的 一 些 配置 ， 包 括 协 议 、 端 口 、 主 机 、 用 户 名 、 密 码 ， 是 否 需 
要 认证 等 属性 。 这 段 配置 还 使 用 了 Spring Framework 的 属性 引用 ， 比 如 
host 的 值 为 $ {email.host}， 之 前 定义 propertyConfigurer 的 作用 就 在 于 
此 。 这 么 做 可 以 将 邮件 服务 器 相关 的 配置 分 离 到 外 部 的 properties 文 件 
中 ， 比 如 可 以 定义 这 样 一 个 properties 文 件 ， 配 置 javaMailSender 使 用 


gmail: 
email. protocol =smtps 
email.host =smtp. gmail.com 
email.port =465 
email.username =your-id@ gmail.com 
email.password =your-password 
email.auth =true 


email. systemEmail =your-id@ juvenxu. com 


这 样 ，javaMailSender 实 际 使 用 的 protocol 就 会 成 为 smtps，host 会 成 


为 smtp.gmail.com， 同 理 还 有 port、username 等 其 他 属性 。 


最 后 一 个 bean 是 accountEmailService， 对 应 了 之 前 描述 的 


com.juvenxu.mvnbook.account.email.AccountEmailServiceImpl1， 配 置 中 将 
另外 一 个 bean javaMailSender 注 入 ， 使 其 成 为 该 类 javaMailSender 字 上 段 的 
值 O 


上 述 就 是 Spring Framework 相 关 的 配置 ， 这 里 不 再 进一步 深入 ， 读 
者 如 果 有 不 是 很 理解 的 地 方 ， 请 查询 Spring Framework 相 关 文 档 。 


5.3.3 account-email 的 测试 代码 


测试 相关 的 Java 代 码 位 于 src/test/java 目 录 ， 相 关 的 资源 文件 则 位 于 


src/test/resources 目 录 。 


该 模块 需要 测试 的 只 有 一 个 AccountEmailService.sendMail () 接 
口 。 为 此 ， 需 要 配置 并 局 动 一 个 测试 使 用 的 邮件 服务 器 ， 然 后 提供 对 应 
的 properties 配 置 文件 供 Spring Framework 载 入 以 配置 程序 。 准 备 就 绪 之 
后 ， 调 用 该 接口 发 送 邮 件 ， 然 后 检查 邮件 是 否 发 送 正确 。 最 后 ， 关 闭 测 
试 邮 件 服务 器 ， 见 代码 清单 5-5。 


代码 清单 5-5 AccountEmailServiceTest.java 


package com. juvenxu.mvnbook. account. email; 
import static junit. framework. Assert. assertEquals; 
import javax.mail. Message; 


import org. junit. After; 

import org. junit. Before; 

import org. junit. Test; 

import org. springframework. context. ApplicationContext; 

import org. springframework. context. support. ClassPathXmlApplicationContext; 


import com. icegreen. greenmail.util.GreenMail; 
import com. icegreen.greenmail.util.GreenMailUril; 
import com. icegreen. greenmail-util.ServerSetup; 


public class AccountEmailServiceTest 
{ 
private GreenMail greenMail; 


@ Before 
public void starcMailServer () 
throws Exception 


{ 
greenMail = new GreenMail { ServerSetup. SMTP ); 
greenMail.setUser( "test@ juvenxu.com", "123456" ); 
greenMail.start (}; 

} 

@ Test 


public void testSendMail () 
throws Exception 
{ 
ApplicationContext ctx = new ClassPathXmiApplicationContext ( “account- 
email.xmi* ); 
AccountEmailService accountEmailService = (AccountEmailService ) 
etx. getBean({ "“accountEmailService” ); 


String subject = "Test Subject"; 
String htmlText = “*<h3 >Test < /h3 >"; 


uuntEmailService.sendMail ( *test@ juvenxu.com", "test2@ juvenxu. 


i ubj htmlText ) 
greenMail.waitForincomingEmail (2000, 1 }; 
fessagel] msgs = gree jetReceivedMessages (| 
rt 1 { msgs. len i" 
tEqu t subject, msgs [0]. getSub tt) 

asse rtEq mlText ; nMailvril B nsd ) ní) 
@ After 
publ id sto l: r 

r Except 


这 里 使 用 GreenMail 作 为 测试 邮件 服务 器 ， 在 startMailServer () 
中 ， 基 于 SMTP 协 议 初始 化 GreenMail， 然 后 创建 一 个 邮件 账户 并 启动 邮 
件 服 务 ， 该 服务 默认 会 监听 25 端 口 。 如 果 你 的 机 咯 己 经 有 程序 使 用 该 端 
口 ， 请 配置 自 定 义 的 ServerSetup 实 例 使 用 其 他 端口 。startMailServer () 


方法 使 用 了 @before 标 注 ， 表 示 该 方法 会 先 于 测试 方法 〈@test) 之 前 执 
AT 


对 应 于 startMailServer © ， 该 测试 还 有 一 个 stopMailServer © 77 


法 ， 标 注 @After 表 示 执 行 测 试 方法 之 后 会 调用 该 方法 ， 停 止 GreenMtail 
的 邮件 服务 。 


代码 的 重点 在 于 使 用 了 @Test 标 注 的 testSendMail O 方法 ， 该 方法 
首先 会 根据 classpath 路 径 中 的 accountremail.xml 配 置 创 建 一 个 Spring 
Framework 的 ApplicationContext， 然 后 从 这 个 ctx 中 获取 需要 测试 的 id 为 


accountEmailService 的 bean， 并 转换 成 AccountEmailService 接 口 ， 针 对 接 


口 测试 是 一 个 单元 测试 的 最 佳 实践 。 得 到 了 AccountEmailService 之 后 ， 
就 能 调用 其 sendMail O 方法 发 送 电 子 邮件 。 当 然 ， 这 个 时 候 不 能 忘 了 
邮件 服务 器 的 配置 ， 其 位 于 src/test/resources/service.properties: 


email.protocol = smtp 
email.host =localhost 


email.port =25 


email.username =test@ juvenxu.com 
email. password =123456 
email. auth =true 


email. systemEmail =your-id@ juvenxu. com 


这 段 配置 与 之 前 GreenMail 的 配置 对 应 ， 使 用 了 smtp 协 议 ， 使 用 本 
机 的 25 端 口 ， 并 有 用 户 名 、 密 码 等 认证 配置 。 





回 到 测试 方法 中 ， 邮 件 发 送 完毕 后 ， 再 使 用 GreenMail 进 行 检查 。 
greenMail.waitForIncomingEmail (2000，1) 表示 接收 一 封 邮 件 ， 最 多 等 
待 2 秒 。 由 于 GreenMail 服 务 完全 基于 内 存 ， 实 际 情况 下 基本 不 会 超过 2 
秒 。 随 后 的 几 行 代码 读 取 收 到 的 邮件 ， 检 查 邮 件 的 数目 以 及 第 一 封 邮件 
的 主题 和 内 容 。 





这 时 ， 可 以 运行 mvn clean test 执 行 测试 ，Maven 会 编译 主 代 码 和 测 
试 代码 ， 并 执行 测试 ， 报 告 一 个 测试 得 以 正确 执行 ， 构 建成 功 。 


5.3.4 构建 account-email 


使 用 mvn clean install 构 建 account-email，Maven 会 根据 POM 配 置 自 
动 下 载 所 需要 的 依赖 构件 ， 执 行 编 译 、 测 试 、 打 包 等 工作 ， 最 后 将 项 目 
生成 的 构件 account-email-1.0.0-SNAPSHOT.jar 安 装 到 本 地 仓库 中 。 这 
时 ， 该 模块 就 能 供 其 他 Maven 项 目 使 用 了 。 


5.4 依赖 的 配置 


5.3.1 节 已 经 罗列 了 一 些 简单 的 依赖 配置 ， 读 者 可 以 看 到 依赖 会 有 基 
本 的 groupId、artifactId4 和 version 等 元 陛 组 成 。 其 实 一 个 依赖 声明 可 以 包 


含 如 下 的 一 些 元 又 : 


<project > 


< dependencies > 
< dependency > 
<groupId >... < /groupId > 
<artifactId >...< /artifactid> 
<version>.. < /version> 
< type >.. < /type > 
< scope >... < / scope > 
<optional >.. < /optional > 
<exclusions > 
<exclusion > 


< exclusion > 


< /exclusions > 


< /dGependency > 
< ——— a > 
< 2 roject > 
根 元 素 project 下 的 dependencies 可 以 包含 一 个 或 者 多 个 dependency 元 
素 ， 以 声明 一 个 或 者 多 个 项 目 依 赖 。 每 个 依赖 可 以 包含 的 元 素 有 : 


‘groupld. artifactld#llversion: 依赖 的 基本 坐标 ， 对 于 任何 一 个 依赖 
来 说 ， 基 本 坐标 是 最 重要 的 ，Maven 根 据 坐 标 才能 找到 需要 的 依赖 。 


‘type: 依赖 的 类 型 ， 对 应 于 项 目 坐 标定 义 的 packaging。 大 部 分 情况 
下 ， 该 元 素 不 必 声 明 ， 其 默认 值 为 jar。 


‘scope: 依赖 的 范围 ， 见 5.5 节 。 
‘optional: 标记 依赖 是 否 可 选 ， 见 5.8 节 。 
‘exclusions: 用 来 排除 传递 性 依赖 ， 见 5.9.1 节 。 


大 部 分 依赖 声明 只 包含 基本 坐标 ， 然 而 在 一 些 特殊 情况 下 ， 其 他 元 
素 至 关 重 要 。 本 章 下 面 的 小 节 会 对 它们 的 原理 和 使 用 方式 详细 介绍 。 


5.5 依赖 范围 


上 一 节 提 到 ，JUnit 依 赖 的 测试 范围 是 test， 测 试 范围 用 元 素 scope 表 
示 。 本 市 将 详细 解释 什么 是 测试 范围 ， 以 及 各 种 测试 范围 的 效果 和 用 
途 。 


首先 需要 知道 ，Maven 在 编译 项 目 主 代码 的 时 候 需 要 使 用 一 套 
classpath。 在 上 例 中 ， 编 译 项 目 主 代码 的 时 候 需 要 用 到 spring-core， 该 
文件 以 依赖 的 方式 被 引入 到 classpath 中 。 其 次 ，Maven 在 编译 和 执行 测 
试 的 时 候 会 使 用 另外 一 套 classpath。 上 例 中 的 JUnit 就 是 一 个 很 好 的 例 
子 ， 该 文件 也 以 依赖 的 方式 引入 到 测试 使 用 的 dlasspath 中 ， 不 同 的 是 这 
里 的 依赖 范围 是 test。 最 后 ， 实 际 运行 Maven 项 目的 时 候 ， 又 会 使 用 一 套 
classpath， 上 例 中 的 spring-core 需 要 在 该 classpath 中 ， 而 JUnit 则 不 需要 。 


依赖 范围 就 是 用 来 控制 依赖 与 这 三 种 classpath (编译 classpath、 测 
试 classpath、 运 行 classpath) 的 关系 ，Maven 有 以 下 几 种 依赖 范围 : 


‘compile: 编译 依赖 范围 。 如 有 果 没 有 指定 ， 就 会 玖 认 使 用 该 依赖 范 
围 。 使 用 此 依赖 范围 的 Maven 依 赖 ， 对 于 编译 、 测 试 、 运 行 三 种 
classpath 都 有 效 。 典 型 的 例子 是 spring-core， 在 编译 、 测 试 和 运行 的 时 
候 都 需要 使 用 该 依赖 。 


test: 测试 依赖 范围 。 使 用 此 依赖 范围 的 Maven 依 赖 ， 只 对 于 测试 





classpath 有 效 ， 在 编译 主 代 码 或 者 运行 项 目的 使 用 时 将 无 法 使 用 此 类 依 
赖 。 典 型 的 例子 是 JUnit， 它 只 有 在 编译 测试 代码 及 运行 测试 的 时 候 才 需 


要 。 


‘provided: 已 提供 依赖 范围 。 使 用 此 依赖 范围 的 Maven 依 赖 ， 对 于 
编译 和 测试 classpath 有 效 ， 但 在 运行 时 无 效 。 典 型 的 例子 是 servlet-api， 
编译 和 测试 项 目的 时 候 需 要 该 依赖 ， 但 在 运行 项 目的 时 候 ， 由 于 容器 已 
经 提供 ， 就 不 需要 Maven 重 复 地 引入 一 遍 。 








‘runtime: 运行 时 依赖 范围 。 使 用 此 依赖 范围 的 Maven 依 赖 ， 对 于 
测试 和 运行 classpath 有 效 ， 但 在 编译 主 代码 时 无 效 。 典 型 的 例子 是 JDBC 
驱动 实现 ， 项 目 主 代码 的 编译 只 需要 JDK 提 供 的 JDBC 接 口 ， 只 有 在 执 
行 测试 或 者 运行 项 目的 时 候 才 需要 实现 上 述 接口 的 具体 JDBC 豫 动 。 





‘system: 系统 依赖 范围 。 该 依赖 与 三 种 classpath 的 关系 ， 和 
provided 依 赖 范 围 完全 一 致 。 但 是 ， 使 用 System 范围 的 依赖 时 必须 通过 
systemPath 元 素 显 式 地 指定 依赖 文件 的 路 径 。 由 于 此 类 依赖 不 是 通过 
Maven 仓 库 解 析 的 ， 而 且 往 往 与 本 机 系统 绑 定 ， 可 能 造成 构建 的 不 可 移 
植 ， 因 此 应 该 谨慎 使 用 。systemPath 元 素 可 以 引用 环境 变量 ， 如 : 





< scope > system < /scope > 
<systemPath > $ (java. home}/lib/rt.jar</systemPath > 


< /dependency > 


‘import (Maven 2.0.9 及 以 上 ) : 导入 依赖 范围 。 该 依赖 范围 不 会 对 
三 种 classpath 产 生 实 际 的 影响 ， 本 书 将 在 8.3.3 节 介绍 Maven 依 赖 和 
dependencyManagement 的 时 候 详细 介绍 此 依赖 范围 。 


上 述 除 import 以 外 的 各 种 依赖 范围 与 三 种 classpath 的 关系 如 表 5-1 所 


ZN o 
He y 
表 5-1 依赖 范围 与 casspath 的 关系 

依赖 范围 对 于 编译 对 于 测试 对 于 运行 时 i] £ 

(Scope) classpath 有 效 classpath 有 效 classpath 有 效 

compile Y Y Y spring-core 

test = Y 一 JUnit 

provided X Y = servlet-api 

runtime — Y ¥ JDBC 3K ay EIR 

system Y ¥ = 本 地 的 ，Maven 仓库 之 外 


的 类 库 文件 


5.6 [RIETER 


5.6.1 何 为 传递 性 依赖 


考虑 一 个 基于 Spring Framework 的 项 目 ， 如 果 不 使 用 Maven， 那 么 
在 项 目 中 就 需要 手动 下 载 相关 依赖 。 由 于 Spring Framework 又 会 依赖 于 
其 他 开源 类 库 ， 因 此 实际 中 往往 会 下 载 一 个 很 大 的 如 spring-framework- 
2.5.6-with-dependencies.zip 的 包 ， 这 里 包含 了 所 有 Spring Framework 的 jar 
包 ， 以 及 所 有 它 依赖 的 其 他 jar 包 。 这 么 做 往往 就 引入 了 很 多 不 必要 的 依 
赖 。 另 一 种 做 法 是 只 下 载 spring-framework-2.5.6.zip 这 样 一 个 包 ， 这 里 不 
包含 其 他 相关 依赖 ， 到 实际 使 用 的 时 候 ， 再 根据 出 错 信息 ， 或 者 查询 相 
关 文档 ， 加 入 需要 的 其 他 依赖 。 很 显然 ， 这 也 是 一 件 非 常 麻 烦 的 事情 。 














Maven 的 传递 性 依赖 机 制 可 以 很 好 地 解决 这 一 问题 。 以 account- 
email 项 目 为 例 ， 该 项 目 有 一 个 org.springframework: spring-core: 2.5.6 
的 依赖 ， 而 实际 上 spring-core 也 有 它 自己 的 依赖 ， 我 们 可 以 直接 访问 位 
于 中 央 仓 库 的 该 构件 的 


POM: http://repo1.maven.org/maven2/org/springframework/spring- 





core/2.5.6/spring-core-2.5.6.pom。 该 文件 包含 了 一 个 commons-logging 依 
赖 ， 见 代码 清单 5-6。 


代码 清单 5-6 ”spring-core 的 commons-logging 依 赖 


< dependency > 
<groupid >commons-logging < /groupId > 
<artifactId >commons-logging < /artifactId> 
<version >1.1.1 < /version > 


< /dependency > 


该 依赖 没有 声明 依赖 范围 ， 那 么 其 依赖 范围 就 是 默认 的 compile。 
同时 回顾 一 下 account-email，spring-core 的 依赖 范围 也 是 compile。 


account-mail 有 一 个 compile 范 围 的 Spring-core 依 赖 ，spring-core 有 一 
个 compile 和 范围 的 commons-logging 依 赖 ， 那 么 commons-logging 就 会 成 为 
account-email 的 compile 范 围 依赖 ，commons-logging 是 account-email 的 一 


个 传递 性 依赖 ， 如 图 5-2 所 示 。 


-= oe m m 一 一 =e 
Pt ae i ae 
ae t 
mm 


一 =~ 
account-email -———* spring-core —— commons-logging 
—_—— —— 下 


图 5-2 ”传递 性 依赖 


有 了 传递 性 依赖 机 制 ， 在 使 用 Spring Framework 的 时 候 就 不 用 去 考 
虚 它 依赖 了 什么 ， 也 不 用 担心 引入 多 余 的 依赖 。Maven 会 解析 各 个 直接 
依赖 的 POM， 将 那些 必要 的 间接 依赖 ， 以 传递 性 依赖 的 形式 引入 到 当前 
的 项 目 中 。 


5.6.2 ”传递 性 依赖 和 依赖 范围 


依赖 范围 不 仅 可 以 控制 依赖 与 三 种 classpath 的 关系 ， 还 对 传递 性 依 
赖 产 生 影 响 。 上 面 的 例子 中 ，accountremail 对 于 spring-core 的 依赖 范 
是 compile，spring-core 对 于 commons-logging 的 依赖 范围 是 compile， 那 
么 account-email 对 于 commons-logging 这 一 传递 性 依赖 的 范围 也 就 是 
compile。 假 设 A 依赖 于 B，B 依 赖 于 C， 我 们 说 A 对 于 B 是 第 一 直接 依 
赖 ，B 对 于 C 是 第 二 直接 依赖 ，A 对 于 C 是 传递 性 依赖 。 第 一 直接 依赖 的 
范围 和 第 二 直接 依赖 的 范围 决定 了 传递 性 依赖 的 范围 ， 如 表 5-2 所 示 ， 
最 左边 一 行 表示 第 一 直接 依赖 范围 ， 最 上 面 一 行 表示 第 二 直接 依赖 范 
， 中 间 的 交叉 单元 格 则 表示 传递 性 依赖 范围 。 




















表 5-2 依赖 范围 影响 传递 性 依赖 


compile test provided runtime 





compile compile = =F runtime 
test test = — test 
provided provided = provided provided 


runtime runtime — = runtime 


为 了 能 够 帮助 读者 更 好 地 理解 表 5-2， 这 里 再 举 个 例子 。account- 
email 项 目 有 一 个 com.icegreen: greenmail: 1.3.1b 的 直接 依赖 ， 我 们 说 这 
是 第 一 直接 依赖 ， 其 依赖 范围 是 test， 而 greenmail 又 有 一 个 javax.mail: 
mail: 1.4 的 直接 依赖 ， 我 们 说 这 是 第 二 直接 依赖 ， 其 依赖 范围 是 





compile。 显 然 javax.mail: mail: 1.4 是 account-email 的 传递 性 依赖 ， 对 照 
表 5-2 可 以 知道 ， 当 第 一 直接 依赖 范围 为 test， 第 二 直接 依赖 范围 是 
compile 的 时 候 ， 传 递 性 依赖 的 范围 是 test， 因 此 javax.mail:; mail: 1.4 是 
account-email 的 一 个 范围 是 test 的 传递 性 依赖 。 











仔细 观察 一 下 表 5-2， 可 以 发 现 这 样 的 规律 : 当 第 二 直接 依赖 的 范 
围 是 compile 的 时 候 ， 传 递 性 依赖 的 范围 与 第 一 直接 依赖 的 范围 一 致 ; 
当 第 二 直接 依赖 的 范围 是 test 的 时 候 ， 依 赖 不 会 得 以 传递 ， 当 第 二 直接 
依赖 的 范围 是 provided 的 时 候 ， 只 传递 第 一 直接 依赖 范围 也 为 provided 的 
依赖 ， 且 传递 性 依赖 的 范围 同样 为 provided;， 当 第 二 直接 依赖 的 范围 是 
runtime 的 时 候 ， 传 递 性 依赖 的 范围 与 第 一 直接 依赖 的 范围 一 致 ， 但 
compile 例 外 ， 此 时 传递 性 依赖 的 范围 为 runtime。 


5.7 ”依赖 调解 


Maven 引 入 的 传递 性 依赖 机 制 ， 一 方面 大 大 简化 和 方便 了 依赖 声 
明 ， 力 一 方面 ， 大 部 分 情况 下 我 们 只 需要 关心 项 目的 直接 依赖 是 什么 ， 
而 不 用 考虑 这 些 直 接 依赖 会 引入 什么 传递 性 依赖 。 但 有 时 候 ， 当 传递 性 
依赖 造成 问题 的 时 候 ， 我 们 惑 需 要 清楚 地 知道 该 传递 性 依赖 是 从 哪 条 依 
赖 路 径 引入 的 。 


例如 ， 项 目 A 有 这 样 的 依赖 关系 : A->B->C->X (1.0) 、A->D- 
>X (2.0) ，X 是 A 的 传递 性 依赖 ， 但 是 两 条 依赖 路 径 上 有 两 个 版 本 的 
X， 那 么 哪个 X 会 被 Maven 解 析 使 用 呢 ? 两 个 版 本 都 被 解析 显然 是 不 对 
的 ， 因 为 那 会 造成 依赖 重复 ， 因 此 必须 选择 一 个 。Maven 依 赖 调解 
(Dependency Mediation) 的 第 一 原则 是 : 路 径 最 近 者 优先 。 该 例 中 
X (1.0) 的 路 径 长 度 为 3， 而 X(2.0) 的 路 径 长 度 为 2， 因 此 X (2.0) 会 
被 解析 使 用 。 


依赖 调解 第 一 原则 不 能 解决 所 有 问题 ， 比 如 这 样 的 依赖 关系 : A- 
>B->Y (1.0) 、A->C->Y (2.0) ，Y (1.0) 和 Y (2.0) 的 依赖 路 径 长 度 
是 一 样 的 ， 都 为 2。 那 么 到 底 谁 会 被 解析 使 用 呢 ? 在 Maven 2.0.8 及 之 前 
的 版 本 中 ， 这 是 不 确定 的 ， 但 是 从 Maven 2.0.9 开 始 ， 为 了 尽 可 能 避免 构 
建 的 不 确定 性 ，Maven 定 义 了 依赖 调解 的 第 二 原则 : 第 一 声明 者 优先 。 
在 依赖 路 径 长 度 相等 的 前 提 下 ， 在 POM 中 依赖 声明 的 顺序 决定 了 谁 会 被 


解析 使 用 ， 顺 序 最 靠 前 的 那个 依赖 优胜 。 该 例 中 ， 如 果 B 的 依赖 声明 在 
C 之 前 ， 那 么 Y (1.0) 就 会 被 解析 使 用 。 


5.8 可 选 依赖 


假设 有 这 样 一 个 依赖 和 关系， 项 目 A 依 赖 于 项 目 B， 项 目 B 依 赖 于 项 目 
X 和 Y，B 对 于 X 和 Y 的 依赖 都 是 可 选 依赖 : A->B、B->X (可 选 ) B- 
>Y《〈 可 选 ) 。 根 据 传递 性 依赖 的 定义 ， 如 果 所 有 这 三 个 依赖 的 范围 都 
是 compile， 那 么 X、Y 就 是 A 的 compile 范 围 传递 性 依赖 。 然 而 ， 由 于 这 
里 X、Y 是 可 选 依赖 ， 依 赖 将 不 会 得 以 传递 。 换 句 话说，X、Y 将 不 会 对 
A 有 任何 影响 ， 如 图 5-3 所 示 。 


m 
an X( 可 选 依赖 ) 

A ES B < 
a Y( 可 选 依赖 ) 
| 


图 5-3 ”可 选 依赖 


为 什么 要 使 用 可 选 依赖 这 一 特性 呢 ? 可 能 项 目 B 实 现 了 两 个 特性 ， 
其 中 的 特性 一 依赖 于 X， 特 性 二 依赖 于 Y， 而 且 这 两 个 特性 是 互 斥 的 ， 
用 户 不 可 能 同时 使 用 两 个 特性 。 比 如 B 是 一 个 持久 层 隔离 工具 包 ， 它 支 
持 多 种 数据 库 ， 包 括 MySQL、PostgreSQL 等 ， 在 构建 这 个 工具 包 的 时 
候 ， 需 要 这 两 种 数据 库 的 驱动 程序 ， 但 在 使 用 这 个 工具 包 的 时 候 ， 只 会 
依赖 一 种 数据 库 。 








项 目 B 的 依赖 声明 见 代码 清单 5-7。 


代码 清单 5-7 可 选 依赖 的 配置 


<project > 
<modelVersion >4.0.0 < /modelVersion > 
<grouplId >com, juvenxu. mvnbook < /qroupId > 
<artifactId>project-b «< /artifactId > 
<version >1.0.0< /version > 


<grouplId >mysql < /groupId > 
<artifactid >mysql-connector-java < /artifactId> 
<version >5.1.10 < /version > 


le < /optional > 





jl </a 
8.4-701.jdbc3 < /version > 
<optional >true «< /optional > 
< /dependency > 
< /Gependencies > 


< /project > 


上 述 XML 代 码 片 段 中 ， 使 用 <optional> 元 素 表 示 mysql-connector- 
java 和 postgresql 这 两 个 依赖 为 可 选 依赖 ， 它 们 只 会 对 当前 项 目 B 产 生 影 
啊 ， 当 其 他 项 目 依赖 于 B 的 时 候 ， 这 两 个 依赖 不 会 被 传递 。 因 此 ， 当 项 
目 A 依 赖 于 项 目 B 的 时 候 ， 如 果 其 实际 使 用 基于 MySQL 数 据 库 ， 那 么 在 
项 目 A 中 就 需要 显 式 地 声明 mysql-connector-java 这 一 依赖 ， 见 代码 清单 
5-8. 


代码 清单 5-8 可 选 依赖 不 被 传递 





最 后 ， 关 于 可 选 依赖 需要 说 明 的 一 点 是 ， 在 理想 的 情况 下 ， 是 不 应 
该 使 用 可 选 依赖 的 。 前 面 我 们 可 以 看 到 ， 使 用 可 选 依赖 的 原因 是 某 一 个 
项 目 实现 了 多 个 特性 ， 在 面向 对 象 设 计 中 ， 有 个 单一 职责 性 原则 ， 意 指 
一 个 类 应 该 只 有 一 项 职责 ， 而 不 是 故 合 太 多 的 功能 。 这 个 原则 在 规划 
Maven 项 目的 时 候 也 同样 适用 。 在 上 面 的 例子 中 ， 更 好 的 做 法 是 为 
MySQL 和 PostgreSQL 分 别 创 建 一 个 Maven 项 目 ， 基 于 同样 的 groupId 分 配 











不 同 的 artifactId， 如 com.juvenxu.mvnbook: project-b-mysql 和 
com.juvenxu.mvnbook: project-b-postgresql， 在 各 自 的 POM 中 声明 对 应 
的 JDBC 驱 动 依赖 ， 而 且 不 使 用 可 选 依 赖 ， 用 户 则 根据 需要 选择 使 用 
project-b-mysql 或 者 project-b-postgresql。 由 于 传递 性 依赖 的 作用 ， 就 不 
用 再 声明 JDBC 驱 动 依赖 。 





5.9 最 佳 实践 





Maven 依 赖 涉及 的 知识 点 比较 多 ， 在 理解 了 主要 的 功能 和 原理 之 
后 ， 最 需要 的 当然 就 是 前 人 的 经 验 总 结 了 ， 我 们 称 之 为 最 佳 实践 。 本 小 
闻 归 纳 了 一 些 使 用 Maven 依 赖 常见 的 技巧 ， 方 便 用 来 避免 和 处 理 很 多 常 


见 的 问题 。 


5.9.1 ”排除 依赖 


传递 性 依赖 会 给 项 目 隐 式 地 引入 很 多 依赖 ， 这 极 大 地 简化 了 项 目 依 
赖 的 管理 ， 但 是 有 些 时 候 这 种 特性 也 会 带 来 问题 。 例 如 ， 当 前 项 目 有 一 
个 第 三 方 依赖 ， 而 这 个 第 三 方 依赖 由 于 某 些 原因 依赖 了 另外 一 个 类 库 的 
SNAPSHOT 版 本 ， 那 么 这 个 SNAPSHOT 就 会 成 为 当前 项 目的 传递 性 依 
赖 ， 而 SNAPSHOT 的 不 稳定 性 会 直接 影响 到 当前 的 项 目 。 这 时 就 需要 排 
除 掉 该 SNAPSHOT， 并 且 在 当前 项 目 中 声明 该 类 库 的 某 个 正式 发 布 的 版 
本 。 还 有 一 些 情况 ， 你 可 能 也 想 要 蔡 换 某 个 传递 性 依赖 ， 比 如 Sun JTA 
API，Hibernate 依 赖 于 这 个 JAR， 但 是 由 于 版 权 的 因素 ， 该 类 库 不 在 中 
央 仓 库 中 ， 而 Apache Geronimo 项 目 有 一 个 对 应 的 实现 。 这 时 你 就 可 以 
排除 Sun JAT API， 再 声明 Geronimo 的 JTA API 实 现 ， 见 代码 清单 5-9。 








代码 清单 5-9 ”排除 传递 性 依赖 


<project > 


<modelVersion >4.0.0 < /modelVersion > 


<groupId >com. juvenxu.mvnbook < /groupId > 
factid>proje < /artifactIid > 
1.0.0 </version > 






<groupId >com. juvenxu. mvnbook < /groupId > 
<artifactId >project-b< /artifactId> 
<version >1.0.0 < /version > 
<exclusions > 
<exclusion > 
<groupid >com. Juvenxu. mvnbook < /groupId > 
<artifactId >project-c < /artifactid> 


< f/exclusion > 






com. juvenxu. mvnbook < /groupId > 
>project-c < /artifactId> 


>1.1.0 < /version > 








上 述 代 码 中 ， 项 目 A 依赖 于 项 目 B， 但 是 由 于 一 些 原因 ， 不 想 引 入 
传递 性 依赖 C， 而 是 自己 显 式 地 声明 对 于 项 目 C 1.1.0 版 本 的 依赖 。 代 码 
中 使 用 exclusions 元 素 声 明 排 除 依赖 ，exclusions 可 以 包含 一 个 或 者 多 个 
exclusion 子 元 素 ， 因 此 可 以 排除 一 个 或 者 多 个 传递 性 依赖 。 需 要 注意 的 
是 ， 声 明 exclusion 的 时 候 只 需要 groupId 和 artifactId， 而 不 需要 version 元 
素 ， 这 是 因为 只 需要 groupId 和 artifactId 就 能 唯一 定位 依赖 图 中 的 某 个 依 
赖 。 换 句 话说 ，Maven 解 析 后 的 依赖 中 ， 不 可 能 出 现 groupId 和 artifactId 
相同 ， 但 是 version 不 同 的 两 个 依赖 ， 这 一 点 在 5.6 节 中 已 做 过 解释 。 该 例 
的 依赖 解析 逻辑 如 图 5-4 所 示 。 


A E_j El Yeo C(version ?) | 
E 
C(version 1.10) 











图 5-4 ”排除 依赖 


5.9.2“” 归 类 依赖 





在 5.3.1 节 中 ， 有 很 多 关于 Spring Framework 的 依赖 ， 它 们 分 别 是 
org.springframework: spring-core: 2.5.6、org.Springframework: spring- 


beans: 2.5.6、org.springframework: spring-context: 2.5.6 和 





org.springframework: spring-context-support: 2.5.6， 它 们 是 来 自 同一 项 
目的 不 同 模块 。 因 此 ， 所 有 这 些 依赖 的 版 本 都 是 相同 的 ， 而 且 可 以 预 
见 ， 如 果 将 来 需要 升级 Spring Framework， 这 些 依赖 的 版 本 会 一 起 升 

级 。 这 一 情况 在 Java 中 似曾相识 ， 考 虑 如 下 简单 代码 《〈 见 代码 清单 5- 

10) 。 


代码 清单 5-10 Java 中 重复 使 用 字面 量 


这 两 个 简单 的 方程 式 计 算 圆 的 周 长 和 面积 ， 稍 微 有 经 验 的 程序 员 一 
眼 就 会 看 出 一 个 问题 ， 使 用 字面 量 〈3.14) 显然 不 合适 ， 应 该 使 用 定义 
一 个 着 量 并 在 方法 中 使 用 ， 见 代码 清单 5-11。 





代码 清单 5-11 Java 中 使 用 常量 


public final double P 


public double c( doubler ) 
return2 * PI * r; 
public double s( double r ) 


mn PT $E e T? 





使 用 第 量 不 仅 让 代码 变 得 更 加 人 简洁， 更 重要 的 是 可 以 避免 重复 ， 在 


需要 更 改 PI 的 值 的 时 候 ， 只 需要 修改 一 处 ， 降 低 了 错误 发 生 的 概率 。 


同 理 ， 对 于 account-email 中 这 些 Spring Framework 来 说 ， 也 应 该 在 一 


个 唯一 的 地 方 定义 版 本 ， 并 且 在 dependency 声 明 中 引用 这 一 版 本 。 这 
样 ， 在 升级 Spring Framework 的 时 候 就 只 需要 修改 一 处 ， 实 现 方式 见 代 





码 清 单 5-12。 


代码 清单 5-12 ”使 用 Maven 属 性 归 类 依赖 


<project > 
<modelVersion >4.0.0 < /modelVersion > 
<groupId >com. juven. mvnbo < /groupid > 





<artifactId >account-email < /artifactId > 


<name >Account Email < /name > 
0.0-SNAPSHOT < /version > 


version >1 


<properties > 
<springframework. version >2.5.6 < /springframework. version > 


< /properties > 


< dependencies > 
< dependency > 


< GroupIQ >org. springframework < /groupId > 
<artifactId >spring-core < /artifactId > 
<version > $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
< GroupIQ >org. springframework < /groupIid > 
<artifactId >spring-beans < /artifactId> 
<version> $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<grouplId >org. springframework < /groupId > 
<artifactId >spring-context < /artifactId> 
<version > $ {springframework. version} < /version > 
< /dependency > 


< dependency > 





<artifactid> 
<version> $ {springframework. version} < /version > 





pring-context-support < /artifactId> 


< /dependency > 


< /dependencies > 


< /project > 


这 里 简单 用 到 了 Maven 属 性 〈14.1 节 会 详细 介绍 Maven 属 性 ) ， 首 
先 使 用 properties 元 素 定 义 Maven 属 性 ， 该 例 中 定义 了 一 个 
springframework.version 子 元 素 ， 其 值 为 2.5.6。 有 了 这 个 属性 定义 之 后 ， 
Maven 运 行 的 时 候 会 将 POM 中 的 所 有 的 $ {springframework.version} 蔡 换 
成 实际 值 2.5.6。 也 就 是 说 ， 可 以 使 用 美元 符号 和 大 括 弧 环绕 的 方式 引用 
Maven 属 性 。 然 后 ， 将 所 有 Spring Framework 依 赖 的 版 本 值 用 这 一 属性 
引用 表示 。 这 和 在 Java 中 用 常量 PI 蔡 换 3.14 是 同样 的 道理 ， 不 同 的 只 是 
语法 





5.9.3 ”优化 依赖 





在 软件 开发 过 程 中 ， 程 序 员 会 通过 重 构 等 方式 不 断 地 优化 自己 的 代 
码 ， 使 其 变 得 更 简洁 、 更 灵活 。 同 理 ， 程 序 员 也 应 该 能 够 对 Maven 项 目 
的 依赖 了 然 于 胸 ， 并 对 其 进行 优化 ， 如 去 除 多 余 的 依赖 ， 显 式 地 声明 采 
些 必要 的 依赖 。 





通过 阅读 本 章 前 面 的 内 容 ， 读 者 应 该 能 够 了 解 到 : Maven 会 自动 解 
析 所 有 项 目的 直接 依赖 和 传递 性 依赖 ， 并 且 根 据 规则 正确 判断 每 个 依赖 
的 范围 ， 对 于 一 些 依 赖 冲突 ， 也 能 进行 调节 ， 以 确保 任何 一 个 构件 只 有 
唯一 的 版 本 在 依赖 中 存在 。 在 这 些 工 作 之 后 ， 最 后 得 到 的 那些 依赖 被 称 
为 已 解析 依赖 (Resolved Dependency) 。 可 以 运行 如 下 的 命令 查看 当前 
项 目的 已 解析 依赖 : 








mvn aepenaency : j st 


在 account-email 项 目 中 执行 该 命令 ， 结 果 如 图 5-5 所 示 。 


Scanning for projects... 
Searching repository for plugin with prefix: ’dependency’. 


Building Account Email 
task-segment: [dependency: list] 


[dependency: list execution: default-cli>] 


The following files have been resolved: 
aopalliance:aopalliance: jar:1.@:compile 
com. icegreen:greenmail: jar:1.3.ib:test 
commons—logging-commons—logging: jar:1.1.1-:compile 
javax.activation:activation: jar:1.1:compile 
javax.mail-:mail: jar:i.4.1:compile 
junit: junit: jar:4.?7:test 
org .slf4j:slf4j-api: jar:1.3.1:test 
org .springf ramework-spring—beans: jar:2.5.6-compile 
org.springf ramevork:spring—context: jar:2.5.6:compile 
org .springframework-:spring—context—support : jar:2.5.6:compile 
org.springf ramework:spring—core: jar:2.5.6:compile 


[INFO] BUILD SUCCESSFUL 
[INFO] ----------------- 





图 5-5 已 解 析 依 赖 列表 





图 5-5 显 示 了 所 有 accountremail 的 已 解析 依赖 ， 同 时 ， 每 个 依赖 的 范 
围 也 得 以 明确 标示 。 





在 此 基础 上 ， 还 能 进一步 了 解 已 解析 依赖 的 信息 。 将 直接 在 当前 项 
目 POM 声 明 的 依赖 定义 为 项 层 依 赖 ， 而 这 些 顶层 依赖 的 依赖 则 定义 为 第 
二 层 依赖 ， 以 此 类 推 ， 有 第 三 、 第 四 层 依赖 。 当 这 些 依赖 经 Maven 解 析 
后 ， 就 会 构成 一 个 依赖 树 ， 通 过 这 要 依 赖 树 就 能 很 清楚 地 看 到 东 个 依赖 
古 通 过 哪 条 传递 路 径 引 入 的 。 可 以 运行 如 下 命令 查看 当前 项 目的 依赖 
树 : 








在 acccount-emaijil 中 执行 该 命令 ， 效 果 如 图 5-6 所 示 。 


Scanning for projects... 
Searching repository for plugin with prefix: ’dependency’. 


Building Account Email 
task-segment: [dependency:tree ] 


C[dependency:tree execution: default—cli>] 
con. juven.munbook.account -account—email: jar:1.6.@—-SNAPSHOT 
+ 一 org.springframework:spring—core: jar:2.5.6:compile 
\- commons-—logging:commons—logging: jar:1.1.1:compile 
org.springf ramework:spring—beans-: jar:2.5.6:compile 
org.springf ramevork:spring—context :jar:2.5.6:compile 
\ aopalliance:aopalliance: jar-:1.@:compile 
org.springf ramevwork:spring—context—support :jar:2.5.6:compile 
javax.mail:mail: jar:1.4.1-:compile 
\ javax.activation:activation: jar:1.1:compile 
junit: junit > jar:4.7:test 
com.icegreen:greenmail: jar:1.3.ib:test 
\ org.slf4j:slf4j-api: jar:1.3.1:test 


BUILD SUCCESSFUL 


图 5-6 ”已 解析 依赖 树 





从 图 5-6 中 能 够 看 到 ， 虽 然 我 们 没有 声明 org.slf4j: slf4j-api: 1.3 这 
一 依赖 ， 但 它 还 是 经 过 com.icegreen: greenmail: 1.3 成 为 了 当前 项 目的 
传递 性 依赖 ， 而 且 其 范围 是 test。 





使 用 dependency: list 和 dependency: tree 可 以 帮助 我 们 详细 了 解 项 
目 中 所 有 依赖 的 具体 信息 ， 在 此 基础 上 ， 还 有 dependency: analyze LA 
可 以 帮助 分 析 当 前 项 目的 依赖 。 





为 了 说 明 该 工具 的 用 途 ， 先 将 5.3.1 节 中 的 spring-context 这 一 依赖 删 
除 ， 然 后 构建 项 目 ， 你 会 发 现 编译 、 测 试 和 打包 都 不 会 有 任何 问题 。 通 
过 分 析 依 赖 树 ， 可 以 看 到 spring-context 是 spring-context-support 的 依赖 ， 
因此 会 得 以 传递 到 项 目的 classspath 中 。 现 在 再 运行 如 下 命令 : 








结果 如 图 5-7 所 示 。 


[INFO] Preparing dependency:analyze 

[INFO] [resources resources execution: default—-resources?] 

[VARNING] Using platform encoding (GB18636 actually» to copy filtered 
[INFO] Copying 1 resource 

CINFO] [compiler:compile execution: default—compile> ] 

[INFO] Nothing to compile — all classes are up to date 

CINFO] [resources:testResources execution: default-testResources> ] 
[VARNING] Using platform encoding (GB18636 actually? to copy filtered 
[INFO] Copying 1 resource 


[INFO] [Ccompiler:testCompile ‘execution: default—testCompile> ] 
LINFO] Nothing to compile 一 all classes are up to date 

[INFO] [dependency:analyze execution: default-—cli>] 

CWARNING] Used undeclared dependencies found: 

[VARNING] org.springf ramework:spring—context: jar:2.5.6:compile 
[VARNING] Unused declared dependencies found: 

[VARNING] org .springf ramework:spring—core: jar:2.5.6:compile 


[VARNING] org .springf ramework:spring—hbeans =: jap:2.5.6:compile 





图 5-7 使 用 但 未 声明 的 依赖 与 声明 但 未 使 用 的 依赖 


该 结果 中 重要 的 是 两 个 部 分 。 首 先是 Used undeclared 
dependencies， 意 指 项 目 中 使 用 到 的 ， 但 是 没有 显 式 声明 的 依赖 ， 这 里 
是 spring-context。 这 种 依赖 意味 着 潜在 的 风险 ， 当 前 项 目 直接 在 使 用 它 
们 ， 例 如 有 很 多 相关 的 Java import 声 明 ， 而 这 种 依赖 是 通过 直接 依赖 传 





递 进来 的 ， 当 升级 直接 依赖 的 时 候 ， 相 关 传 递 性 依赖 的 版 本 也 可 能 发 生 
变化 ， 这 种 变化 不 易 察觉 ， 但 是 有 可 能 导致 当前 项 目 出 错 。 例 如 由 于 接 
口 的 改变 ， 妆 前 项 目 中 的 相关 代码 无 法 编译 。 这 种 隐藏 的 、 潜 在 的 威胁 
一 旦 出 现 ， 就 往往 需要 耗费 大 量 的 时 间 来 查 明 真 相 。 因 此 ， 显 式 声 明 任 
何 项 目 中 直接 用 到 的 依赖 。 











结果 中 还 有 一 个 重要 的 部 分 是 Unused declared dependencies， 意 指 
项 目 中 未 使 用 的 ， 但 显 式 声明 的 依赖 ， 这 里 有 spring-core 和 spring- 
beans。 需 要 注意 的 是 ， 对 于 这 样 一 类 依赖 ， 我 们 不 应 该 简单 地 直接 删 
除 其 声明 ， 而 是 应 该 仔细 分 析 。 由 于 dependency: analyze 只 会 分 析 编 译 
主 代码 和 测试 代码 需要 用 到 的 依赖 ， 一 些 执行 测试 和 运行 时 需要 的 依赖 
它 就 发 现 不 了 。 很 显然 ， 该 例 中 的 spring-core 和 spring-beans 是 运行 
Spring Framework 项 目 必 要 的 类 库 ， 因 此 不 应 该 删除 依赖 声明 。 当 然 ， 
有 时 候 确实 能 通过 该 信息 找到 一 些 没 用 的 依赖 ， 但 一 定 要 小 心 测试 。 














5.10 ”小 结 


本 章 主要 介绍 了 Maven 的 两 个 核心 概念 : 坐标 和 依赖 。 解 释 了 坐标 
的 由 来 ， 并 详细 曾 述 了 各 坐标 元 素 的 作用 及 定义 方式 。 随 后 引入 
account-email 这 一 实际 的 基于 Spring Framework 的 模块 ， 包 括 了 POM 定 
义 、 主 代码 和 测试 代码 。 在 这 一 直观 感受 的 基础 上 ， 再 花 了 大 篇 幅 介绍 
Maven 依 赖 ， 包 括 依 赖 范 围 、 传 递 性 依赖 、 可 选 依赖 等 概念 。 最 后 ， 当 
然 少不了 关于 依赖 的 一 些 最 佳 实践 。 通 过 阅读 本 章 ， 读 者 应 该 已 经 能 够 
透彻 地 了 解 Maven 的 依赖 管理 机 制 。 下 一 章 将 会 介绍 Maven 的 另 一 个 核 


心 概念 : 仓库 o 





. 何 为 Maven 仓 库 


“仓库 的 布局 


仓库 的 分 类 


远程 仓库 的 配置 


快照 版 本 


从 仓库 解析 依赖 的 机 制 


-镜像 


仓库 搜索 服务 


小 结 


第 5 章 详 细 介 绍 了 Maven 坐 标 和 依赖 ， 坐 标 和 依赖 是 任何 一 个 构件 
在 Maven 世 界 中 的 人 逻辑 表示 方式 ; 而 构件 的 物理 表示 方式 是 文件 ， 
Maven 通 过 仓库 来 统一 管理 这 些 文 件 。 本 章 将 详细 介绍 Maven 人 仓库 ， 在 
了 解 了 Maven 如 何 使 用 仓库 之 后 ， 将 能 够 更 高 效 地 使 用 Maven。 


6.1 何 为 Maven 仓 库 


在 Maven 世 界 中 ， 任 何 一 个 依赖 、 插 件 或 者 项 目 构建 的 输出 ， 都 可 
以 称 为 构件 。 例 如 ， 依 赖 1og4j-1.2.15.jar 是 一 个 构件 ， 插 件 maven- 
compiler-plugin-2.0.2.jar 是 一 个 构件 ， 第 5 章 的 account-email 项 目 构 建 完 
成 后 的 输出 account-email-1.0.0-SNAPSHOT.jar 也 是 一 个 构件 。 任 何 一 个 
构件 都 有 一 组 坐标 唯一 标识 。 


在 一 台 工 作 站 上 ， 可 能 会 有 几 十 个 Maven 项 目 ， 所 有 项 目 都 使 用 
maven-compiler-plugin， 这 些 项 目 中 的 大 部 分 都 用 到 了 log4j， 有 一 小 部 
分 用 到 了 Spring Framework， 还 有 另外 一 小 部 分 用 到 了 Struts2。 在 每 个 
有 需要 的 项 目 中 都 放置 一 份 重复 的 log4j 或 者 struts2 显 然 不 是 最 好 的 解决 
方 采 ， 这 样 做 不 仅 造 成 了 磁盘 空间 的 浪费 ， 而 且 也 难于 统一 管理 ， 文 件 
的 复制 等 操作 也 会 降低 构建 的 速度 。 而 实际 情况 是 ， 在 不 使 用 Maven 的 
那些 项 目 中 ， 我 们 往往 就 能 发 现 命 名 为 lib/ 的 目录 ， 各 个 项 目 lib/ 目 录 下 
的 内 容 存 在 大 量 的 重复 。 




















得 益 于 坐标 机 制 ， 任 何 Maven 项 目 使 用 任何 一 个 构件 的 方式 都 是 完 

全 相同 的 。 在 此 基础 上 ，Maven 可 以 在 东 个 位 置 统一 存储 所 有 Maven 项 

目 共 至 的 构件 ， 这 个 统一 的 位 置 束 是 仓库 。 实 际 的 Maven 项 目 将 不 再 各 
目 存 储 其 依赖 文件 ， 它 们 只 需要 声明 这 些 依 赖 的 坐标 ， 在 需要 的 时 候 
(例如 ， 编 译 项 目的 时 候 需 要 将 依赖 加 入 到 classpath 中 )〉 ，Maven 会 目 





动 根据 坐标 找到 仓库 中 的 构件 ， 并 使 用 它们 。 


为 了 实现 重用 ， 项 目 构 建 完 毕 后 生成 的 构件 也 可 以 安装 或 者 部 普 到 
仓库 中 ， 供 其 他 项 目 使 用 。 


6.2 仓库 的 布局 


任何 一 个 构件 都 有 其 唯一 的 坐标 ， 根 据 这 个 坐标 可 以 定义 其 在 仓库 
中 的 唯一 存储 路 径 ， 这 便 是 Maven 的 仓库 布局 方式 。 例 如 ，log4j: 
log4j: 1.2.15 这 一 依赖 ， 其 对 应 的 仓库 路 径 为 log4j/log4j/1.2.15/log4j- 
1.2.15.jar， 细 心 的 读者 可 以 观察 到 ， 该 路 径 与 坐标 的 大 致 对 应 关系 为 
groupld/artifactId/version/artifactId-version.packaging. F [fil #— {Maven 
的 源码 ， 并 结合 具体 的 实例 来 理解 Maven 仓 库 的 布局 方式 ， 见 代码 清单 
6-1: 








代码 清单 6-1 Maven 处 理 仓库 布局 的 源码 


rivate static final char PATH_SEPARATOR ='/'; 


public String pathOf( Artifact artifact ) 
ArtifactHandler artifactHandler =artifact.getArtifactHandler (); 
StringBuilder path =new StringBuilder (128 ); 


path. append ( formatAsDirectory ( artifact.getGrouplId({) ) ). append( PATH_SEPA- 
RATOR ); 
() ). append ( PATH_SEPARATOR ); 
path. append( artifact. getBaseVersion() ).append( PATH_SEPARATOR ); 
path. append( artifact. getArtifactId() ). append ( ARTIFACT_SEPARATOR ). append 


path. append( artifact. getArtifactId({) 


( artifact. getVersion() ); 


if (artifact. hasClassifier() ) 


{ 
t 


path. append ( ARTIFACT_SEPARATOR ).append( artifact.getClassifier() ); 
if ( artifactHandler.getExtension () != null && artifactHandler.getExtension () 
-length() > 0) 


path. append ( GROUP_SEPARATOR ). append ( artifactHandler.getExtension() ); 
} 


return path. toString (); 


private String formatAsDirectory ( String directory ) 


return directory. replace ( GROUP_SEPARATOR, PATH_SEPARATOR ); 





pathOf O 方法 的 目的 是 根据 构件 信息 生成 其 在 仓库 中 的 路 径 。 
在 阅读 本 段 代码 之 前 ， 可 以 先 回 顾 一 下 第 5 章 的 相关 内 容 。 这 里 根据 一 
个 实际 的 例子 来 分 析 路 径 的 生成 ， 考 虑 这 样 一 个 构件 : 
groupId=org.testng, artifactId=testng, version=5.8, classifier=jdk15、 


packaging=jar， 其 对 应 的 路 径 按 如 下 步骤 生成 : 


1) 基于 构件 的 groupId 准 备 路 径 ，formatAsDirectory() 将 groupId 
中 的 句点 分 隔 符 转 换 成 路 径 分隔 符 。 该 例 中 ，groupId org.testng 就 会 被 
转换 成 org/testng， 之 后 再 加 一 个 路 径 分 隔 符 斜 杜 ， 那 么 ，org.testng 就 成 


为 了 org/testng/。 


2) 基于 构件 的 artifactId 准 备 路 径 ， 也 束 是 在 前 面 的 基础 上 加 上 
artifactId 以 及 一 个 路 径 分 隅 符 。 该 例 中 的 artifactId 为 testhg， 那 么 ， 在 这 


一 步 过 后 ， 路 径 束 成 为 了 org/testng/testng/。 


3) 使 用 版 本 信息 。 在 前 面 的 基础 上 加 上 version 和 路 径 分 隔 符 。 该 
例 中 版 本 是 5.8， 那 么 路 径 就 成 为 了 org/testng/tesgng/5.8/。 


4) 依次 加 上 artifactd， 构 件 分 隔 符 连 字号 ， 以 及 version， 于 是 构建 
的 路 径 就 变 成 了 org/testng/testng/5.8/testng-5.8。 读 者 可 能 会 注意 到 ， 这 
里 使 用 了 artifactId.getVersion() ， 而 上 一 步 用 的 是 
artifactId.getBaseVersion () ，baseVersion 主 要 是 为 SNAPSHOT 版 本 服 
务 的 ， 例 如 version 为 1.0-SNAPSHOT 的 构件 ， 其 baseVersion 就 是 1.0。 


5) 如 果 构 件 有 classifier， 就 加 上 构件 分 隔 符 和 classifier。 该 例 中 构 
件 的 classifier 是 jdk15， 那 么 路 径 就 变 成 org/testng/testng/5.8/testng-5.8- 
jdks。 


6) 检查 构件 的 extension， 知 extension 存 在 ， 则 加 上 和 句点 分 隔 符 和 
extension。 从 代码 中 可 以 看 到 ，extension 是 从 artifactHandler 而 非 artifact 
获取 ，artifactHandler 是 由 项 目的 packaging 决 定 的 。 因 此 ， 可 以 说 ， 
packaging 决 定 了 构件 的 扩展 名 ， 该 例 的 packaging 是 jar， 因 此 最 终 的 路 
径 为 org/testng/testng/5.8/testng-5.8-jdk5.jar。 





到 这 里 ， 应 该 感谢 Maven 开 源 社区 ， 正 是 由 于 Maven 的 所 有 源 代码 
都 是 开放 的 ， 我 们 才能 仔细 地 深入 到 其 内 部 工作 的 所 有 细节 。 


Maven 仓 库 是 基于 简单 文件 系统 存储 的 ， 我 们 也 理解 了 其 存储 方 
式 ， 因 此 ， 当 过 到 一 些 与 仓库 相关 的 问题 时 ， 可 以 很 方便 地 但 找 相关 文 
件 ， 方 便 定位 问题 。 例 如 ， 当 Maven 无 法 获得 项 目 声 明 的 依赖 时 ， 可 以 
查看 该 依赖 对 应 的 文件 在 仓库 中 是 否 存在 ， 如 果 不 存 在 ， 碍 看 是 否 有 其 
他 版 本 可 用 ， 等 等 。 








6.3 ”仓库 的 分 类 


对 于 Maven 来 说 ， 仓 库 只 分 为 两 类 : 本 地 仓库 和 远程 仓库 。 当 
Maven 根 据 坐 标 寻 找 构 件 的 时 候 ， 它 首先 会 查看 本 地 仓库 ， 如 果 本 地 仓 
库存 在 此 构件 ， 则 直接 使 用 ， 如 有 果 本 地 仓库 不 存在 此 构件 ， 或 者 需要 得 
看 是 人 否 有 更 新 的 构件 版 本 ，Maven 就 会 去 远程 仓库 碍 找 ， 发 现 需要 的 构 
件 之 后 ， 下 载 到 本 地 仓库 再 使 用 。 如 果 本 地 仓库 和 远程 仓库 都 没有 需要 
的 构件 ，Maven 就 会 报错 。 








在 这 个 最 基本 分 类 的 基础 上 ， 还 有 必要 介绍 一 些 特殊 的 远程 仓库 。 
中 央 仓 库 是 Maven 核 心 自 带 的 远程 仓库 ， 它 包含 了 绝 大 部 分 开源 的 构 
件 。 在 默认 配置 下 ， 当 本 地 仓库 没有 Maven 需 要 的 构件 的 时 候 ， 它 就 会 
尝试 从 中 央 仓 库 下 载 。 





私服 是 另 一 种 特殊 的 远程 仓库 ， 为 了 节省 带宽 和 时 间 ， 应 该 在 局 域 
网 内 架设 一 个 私有 的 仓库 服务 器 ， 用 其 代理 所 有 外 部 的 远程 仓库 。 内 部 
的 项 目 还 能 部 获 到 私服 上 供 其 他 项 目 使 用 。 


除了 中 央 仓 库 和 私服 ， 还 有 很 多 其 他 公开 的 远程 仓库 ， 常 见 的 有 
Java.net Maven 库 (http://download.java.net/maven/2/) 和 JBoss Maven 库 


(http://repository.jboss.com/maven2/〉 等 。 


Maven 仓 库 的 分 类 见 图 6-1。 


Maven 仓库 





图 6-1 Maven 仓 库 的 分 类 


6.3.1 本 地 仓库 


一 般 来 说 ， 在 Maven 项 目 目录 下 ,没有 诸如 lib/ 这 样 用 来 存放 依赖 文 
件 的 目录 。 当 Maven 在 执行 编译 或 测试 时 ， 如 果 需 要 使 用 依赖 文件 ， 它 
总 是 基于 坐标 使 用 本 地 仓库 的 依赖 文件 。 











默认 情况 下 ， 不 管 是 在 Windows 还 是 Linux 上 ， 每 个 用 户 在 自己 的 
用 户 目录 下 都 有 一 个 路 径 名 为 .m2/repository/ 的 仓库 目录 。 例 如 ， 笔 者 的 
用 户 名 是 juven， 我 在 windows 机 器 上 的 本 地 仓库 地 址 为 C: 
\Users\ijuven\.m2\repository\， 而 我 在 Linux 上 的 本 地 仓库 地 址 
为 /home/juven/.m2/repository/。 注 意 ， 在 Linux 系 统 中 ， 以 点 〈(.) 开头 的 
文件 或 目录 默认 是 隐藏 的 ， 可 以 使 用 ls-a 命 令 显示 隐藏 文件 或 目录 。 


有 时 候 ， 因 为 某 些 原因 【例如 C 盘 空间 不 够 ) ， 用 户 会 想 要 上 自 定义 
本 地 仓库 目录 地 址 。 这 时 ， 可 以 编辑 文件 ~/.m2/settings.xml， 设 置 
localRepository 元 素 的 值 为 想 要 的 仓库 地 址 。 例 如 : 


< localRepository >D:\java \repository \< /localRepository > 


< /settinas > 


这 样 ， 该 用 户 的 本 地 仓库 地 址 就 被 设置 成 了 D: \java\repository\. 





需要 注意 的 是 ， 默 认 情 况 下 ，~/.m2/settings.xml 文 件 是 不 存在 的 ， 
用 户 需 要 从 Maven 安 装 日 录 复 制 $ M2_HOME/conf/settings.xml 文 件 再 进 
行 编辑 。 本 书 始 终 推荐 大 家 不 要 直接 修改 全 局 目录 的 settings.xml 文 件 ， 
具体 原因 已 在 第 2.7.2 节 中 阐述 





一 个 构件 只 有 在 本 地 仓库 中 之 后 ， 才 能 由 其 他 Maven 项 目 使 用 ， 那 
么 构件 如 何 进 入 到 本 地 仓库 中 呢 ? 最 币 见 的 是 依赖 Maven 从 远程 仓库 下 
载 到 本 地 仓库 中 。 还 有 一 种 常见 的 情况 证， 将 本 地 项 目的 构件 安装 到 
Maven 仓 库 中 。 例 如 ， 本 地 有 两 个 项 目 A 和 B， 两 者 都 无 法 从 远程 仓库 获 
得 ， 而 同时 A 又 依赖 于 B， 为 了 能 构建 A，B 束 必须 首先 得 以 构建 并 安 沪 
到 本 地 仓库 中 。 














在 某 个 项 目 中 执行 mvn clean install 命 令 ， 束 能 看 到 如 下 输出 : 





INFO] [jar:jar {execution: default-jar}] 

INFO] Building r: D:\git-juven \maven-book \ code \ch-5 \account -email \target 
\account-email-1.0.0-SNAPSHOT. jar 

INFO] aata ie tall {executi default-install}] 

INFO] Installing D:\git-juven \maven-book \ ae \ch-5 \account-email \target \ac- 
count-email-1.0.0-SNAPSHOT. jar to D: \java\repository \com\juven \mvnbook \account \ 
account-—-email \1.0.0 -SNAPSHOT \account-email-1. 0 . 0-SNAPSHOT. jar 

NFO] ese eee eee eee eee ee ee Se ee ee eee eee eee eee ee 
NFO] BUILD : E UL 
NEO] es ns eer ees ere es eee ees ert eee ees cee see eee 








install 插 件 的 install 目 标 将 项 目的 构建 输出 文件 安装 到 本 地 仓库 。 在 
上 述 输出 中 ， 构 建 输出 文件 是 account-email-1.0.0-SNAPSHOT.jar， 本 地 
仓库 地 址 是 D: \java\repository，Maven 使 用 Install 插 件 将 该 文件 复制 到 
本 地 仓库 中 ， 具 体 的 路 径 根据 坐标 计算 获得 。 计 算 逻 辑 请 参考 6.2 节 。 


6.3.2 ”远程 仓库 


安装 好 Maven 后 ， 如 果 不 执行 任何 Maven 命 令 ， 本 地 仓库 目录 是 不 
存在 的 。 当 用 户 输入 第 一 条 Maven 命 令 之 后 ，Maven 才 会 创建 本 地 仓 
库 ， 然 后 根据 配置 和 需要 ， 从 远程 仓库 下 载 构 件 至 本 地 仓库 。 





这 好 比 藏书 。 例 如 ， 我 想 要 读 《 红 楼 梦 》， 会 先 检查 自己 的 书房 是 
个 已 经 收藏 了 这 本 书 ， 如 傈 发现 没 有 这 本 书 ， 于 是 束 跑 去 书店 买 一 本 回 
来 ， 放 到 书房 里 。 可 能 有 一 天 我 又 想 读 一 本 英文 版 的 《程序 员 修 炼 之 
道 》， 而 书房 里 只 有 中 文 版 ， 于 是 又 去 书店 找 ， 可 发 现 书 店 没有 ， 好 在 
还 有 网 上 书店 ， 于 是 从 Amazon 买 了 一 本 ， 几 天 后 我 收 到 了 这 本 书 ， 又 
放 到 了 上 自己 的 书房 。 





本 地 仓库 就 好 比 书房 ， 我 需要 读书 的 时 候 先 从 书房 找 ， 相 应 地 ， 
Maven 需 要 构件 的 时 候 先 从 本 地 仓库 找 。 远 程 仓库 束 好 比 书店 (包括 实 
体 书店 、 网 上 书店 等 ) ， 当 我 无 法 从 目 己 的 书房 找到 需要 的 书 的 时 候 ， 
就 会 从 书店 购买 后 放 到 书房 里 。 当 Maven 无 法 从 本 地 仓库 找到 需要 的 构 
件 的 时 候 ， 就 会 从 远程 仓库 下 载 构件 至 本 地 人 仓库。 一般 地 ， 对 于 每 个 人 
来 说 ， 书 房 只 有 一 个 ， 但 外 面 的 书店 有 很 多 ， 类 似 地 ， 对 于 Maven 来 
说 ， 每 个 用 户 只 有 一 个 本 地 仓库 ， 但 可 以 配置 访问 很 多 远程 仓库 。 











6.3.3 ”中 央 仓 库 


由 于 最 原始 的 本 地 仓库 是 空 的 ，Maven 必 须知 道 至 少 一 个 可 用 的 远 
程 仓库 ， 才 能 在 执行 Maven 命 令 的 时 候 下 载 到 需要 的 构件 。 中 央 仓 库 就 
是 这 样 一 个 默认 的 远程 仓库 ，Maven 的 安装 文件 自 带 了 中 央 仓 库 的 配 
置 。 读 者 可 以 使 用 解压 工具 打开 jar 文 件 $ M2_HOME/Nib/maven-model- 
builder-3.0.jar〈 在 Maven 2 中 ，jar 文 件 路 径 类 似 于 
$ M2_HOME/lib/maven-2.2.1-uber.jar) ， 然 后 访问 路 径 
org/apache/maven/model/pom-4.0.0.xml， 可 以 看 到 如 下 的 配置 : 
<repositories > 
<repository > 
<id>central </id> 
<name >Maven Repository Switchboard < /name > 


<url >http://repol.maven.org/maven2 < /url > 
< layout >default < /layout > 
< snapshots > 
< enabled > false < /enabled > 
< / snapshots > 
< / repository > 


/repositories > 


包含 这 段 配置 的 文件 是 所 有 Maven 项 目 都 会 继承 的 超级 PZOM， 第 8 
章 会 详细 介绍 继承 及 超级 POM。 这 段 配置 使 用 id central 对 中 央 仓 库 进 行 
唯一 标识 ， 其 名 称 为 Maven Repository Switchboard， 它 使 用 default 仓 库 
布局 ， 也 就 是 在 第 6.2 节 介绍 的 仓库 布局 。 对 于 Maven 1 的 仓库 ， 需 要 配 
置 值 为 legacy 的 layout， 本 书 不 会 涉及 Maven 1。 最 后 需要 注意 的 是 








snapshots 元 素 ， 其 子 元 素 enabled 的 值 为 false， 表 示 不 从 该 中 央 仓 库 下 载 
快照 版 本 的 构件 (本 章 稍 后 详细 介绍 快照 版 本 〉。 





中 央 仓 库 包 含 了 这 个 世界 上 绝 大 多 数 流 行 的 开源 Java 构 件 ， 以 及 源 
码 、 作 者 信息 、SCM、 信 息 、 许 可 证 信息 等 ， 每 个 月 这 里 都 会 接受 全 世 
界 Java 程 序 员 大 概 1 亿 次 的 访问 ， 它 对 全 世界 Java 开 发 者 的 贡献 由 此 可 见 
一 斑 。 由 于 中 央 仓库 包含 了 超过 2000 个 开源 项 目的 构件 ， 因 此 ， 一 般 来 
说 ， 一 个 简单 Maven 项 目 所 需要 的 依赖 构件 都 能 从 中 央 仓 库 下 载 到 。 这 
也 解释 了 为 什么 Maven 能 做 到 “ 开 箱 即 用 ”。 





6.3.4 私服 


私服 是 一 种 特殊 的 远程 仓库 ， 它 是 架设 在 局 域 网 内 的 仓库 服务 ， 私 
服 代 理 广 域 网 上 的 远程 仓库 ， 供 局 域 网 内 的 Maven 用 户 使 用 。 当 Maven 
需要 下 载 构件 的 时 候 ， 它 从 私服 请 求 ， 如 果 私 服 上 不 存在 该 构件 ， 则 从 
外 部 的 远程 仓库 下 载 ， 缓 存在 私服 上 之 后 ， 再 为 Maven 的 下 载 请 求 提供 
服务 。 此 外 ， 一 些 无 法 从 外 部 仓库 下 载 到 的 构件 也 能 从 本 地 上 传 到 私服 
上 供 大 家 使 用 ， 如 图 6-2 所 示 。 








缓存 构件 JBoss 仓库 


Maven 用 户 


图 6-2 ”私服 的 用 途 





图 6-2 展 示 的 是 组 织 内 部 使 用 私服 的 情况 。 即 使 在 一 台 直 接连 入 
Iternet 的 个 人 机 器 上 使 用 Maven， 也 应 该 在 本 地 建立 私服 。 因 为 私服 可 
以 帮助 你 : 


市 省 目 己 的 外 网 带 冤 。 建 立 私服 同样 可 以 减少 组 织 自 己 的 开 文 ， 
大 量 的 对 于 外 部 仓库 的 重复 请 求 会 消耗 很 大 的 带宽 ， 利 用 私服 代理 外 部 
仓库 之 后 ， 对 外 的 重复 构件 下 载 便 得 以 消除 ， 即 降低 外 网 带宽 的 压力 。 


加速 Maven 构 建 。 不 停 地 连接 请 求 外 部 仓库 是 十 分 耗 时 的 ， 但 是 
Maven 的 一 些 内 部 机 制 ( 如 快照 更 新 检查 〉 要求 Maven 在 执行 构建 的 时 
候 不 停 地 检查 远程 仓库 数据 。 因 此 ， 当 项 目 配置 了 很 多 外 部 远程 仓库 的 
时 候 ， 构 建 的 速度 会 被 大 大 降低 。 使 用 私服 可 以 很 好 地 解决 这 一 问题 ， 
当 Maven 只 需要 检查 局 域 网 内 私服 的 数据 时 ， 构 建 的 速度 便 能 得 到 很 大 
程度 的 提高 。 








-部署 第 三 方 构件 。 当 某 个 构件 无 法 从 任何 一 个 外 部 远程 仓库 获 
得 ， 怎 么 办 ? 这 样 的 例子 有 很 多 ， 如 组 织 内 部 生成 的 私有 构件 肯定 无 法 
从 外 部 仓库 获得 、Oracle 的 JDBC 了 驱动 由 于 版 权 因 素 不 能 发 布 到 公共 仓库 
中 。 建 并 私服 之 后 ， 便 可 以 将 这 些 构件 部 署 到 这 个 内 部 的 仓库 中 ， 供 内 
部 的 Maven 项 目 使 用 。 





-提高 稳定 性 ， 增 强 控制 。Maven 构 建 高 度 依赖 于 远程 仓库 ， 因 此 ， 
当 Internet 不 稳定 的 时 候 ，Maven 构 建 也 会 变 得 不 稳定 ， 甚 至 无 法 构建 。 
使 用 私服 后 ， 即 使 暂时 没有 Internet 连 接 ， 由 于 私服 中 己 经 缓存 了 大 量 构 
件 ，Maven 也 仍然 可 以 正常 运行 。 此 外 ， 一 些 私服 软件 (如 Nexus) 还 
提供 了 很 多 额外 的 功能 ， 如 权限 管理 、RELEASE/SNAPSHOT 区 分 等 ， 
管理 员 可 以 对 仓库 进行 一 些 更 高 级 的 控制 。 














降低 中 央 仓 库 的 负荷 。 运 行 并 维护 一 个 中 央 仓 库 不 是 一 件 容 易 的 
事情 ， 服 务 数 百 万 的 请 求 ， 存 储 数 T 的 数据 ， 需 要 相当 大 的 财力 。 使 用 
私服 可 以 避免 很 多 对 中 央 仓 库 重 复 的 下 载 ， 想 象 一 下 ， 一 个 有 数 百 位 开 





发 人 员 的 公司 ， 在 不 使 用 私服 的 情况 下 ， 一 个 构件 往往 会 被 重复 下 载 数 
AK; 建 并 私服 之 后 ， 这 几 百 次 下 载 束 只 会 发 生 在 内 网 范围 内 ， 私 服 对 
于 中 央 仓 库 只 有 一 次 下 载 。 


建立 私服 是 用 好 Maven 十 分 关键 的 一 步 ， 第 9 章 会 专门 介绍 如 何 使 
用 最 流行 的 Maven 私 服 软件 


Nexus. 





6.4 远程 仓库 的 配置 


在 很 多 情况 下 ， 默 认 的 中 央 仓 库 无 法 满足 项 目的 需求 ， 
要 的 构件 存在 于 另外 一 个 远程 仓库 中 ， 如 JBoss Maven 仓 库 
以 在 POM 中 配置 该 仓库 ， 见 代码 清单 6-2。 


代码 清单 6-2 ”配置 POM 使 用 JBoss Maven 仓 库 


<project > 


<repositories > 


< /releases > 
<snapshots > 
¿enabled > false < /enabled > 
< / snapshots > 
< layout >default < /layout > 
< /repository > 


< /repositories > 


< /project > 


可 能 项 目 需 


o 这 时 ， 可 


在 repositories 元 素 下 ， 可 以 使 用 repository 子 元 素 声 明 一 个 或 者 多 个 
远程 仓库 。 该 例 中 声明 了 一 个 id 为 jboss， 名 称 为 Je 了 oss Repository 的 仓 
库 。 任 何 一 个 仓库 声明 的 id 必须 是 唯一 的 ， 尤 其 需要 注意 的 是 ，Maven 
自 带 的 中 央 仓 库 使 用 的 id 为 central， 如 果 其 他 的 仓库 声明 也 使 用 该 id， 
就 会 履 盖 中 央 仓 库 的 配置 。 该 配置 中 的 url 值 指向 了 仓库 的 地 址 ， 一 般 来 


说 ， 该 地 址 都 基于 http 协 议 ，Maven 用 户 都 可 以 在 浏览 器 中 打开 仓库 地 
址 浏览 构件 。 


该 例 配 置 中 的 releases 和 snapshots 元 素 比 较 重 要 ， 它 们 用 来 控制 
Maven 对 于 发 布 版 构件 和 快照 版 构件 的 下 载 。 关 于 快照 版 本 ， 在 第 6.5 节 
中 会 详细 解释 。 这 里 需要 注意 的 是 enabled 子 元 素 ， 该 例 中 releases 的 
enabled 值 为 true， 表 示 开 局 JBoss 仓库 的 发 布 版 本 下 载 文 持 ， 而 snapshots 
的 enabled 值 为 false， 表 示 关 闭 J 了 Boss 仓 库 的 快照 版 本 的 下 载 支持 。 
此 ， 根 据 该 配置 ，Maven 只 会 从 JBoss 仓库 下 载 发 布 版 的 构件 ， 而 不 会 下 
载 快照 版 的 构件 。 











该 例 中 的 layout 元 素 值 default 表 示 仓 库 的 布局 是 Maven 2 及 Maven 3 
的 默认 布局 ， 而 不 是 Maven 1 的 布局 。 


对 于 releases 和 snapshots 来 说 ， 除 了 enabled， 它 们 还 包含 另外 两 个 子 


元 素 updatePolicy 和 checksumPolicy: 


< snapshots > 
<enabled >true < /enabled > 


<updatePolicy >daily < /updatePolicy > 


元 素 updatePolicy 用 来 配置 Maven 从 远程 仓库 检查 更 新 的 频率 ， 默 认 
的 值 是 daily， 表 示 Maven 每 天 检查 一 次 。 其 他 可 用 的 值 包括 : never 一 从 
不 检查 更 新 ;always 一 每 次 构建 都 检查 更 新 ;interval: X 一 每 隔 X 分 钟 


检查 一 次 更 新 〈X 为 任意 整数 ) 。 


元 素 checksumPolicy 用 来 配置 Maven 检 查 检验 和 文件 的 策略 。 当 构 
件 被 部 署 到 Maven 仓 库 中 时 ， 会 同时 部 署 对 应 的 校 验 和 文件 。 在 下 载 构 
件 的 时 候 ，Maven 会 验证 校 验 和 文件 ， 如 果 校 验 和 验证 失败 ， 怎 么 办 ? 
当 checksumPolicy 的 值 为 默认 的 warn 时 ，Maven 会 在 执行 构建 时 输出 警 
告 信息 ， 其 他 可 用 的 值 包括 : fail-Maven 遇 到 校 验 和 错误 就 让 构建 失 
败 ，ignore 一 使 Maven 完 全 忽略 校 验 和 错误 。 





6.4.1 远程 仓库 的 认证 


大 部 分 远程 仓库 无 须 认 证 就 可 以 访问 ， 但 有 时 候 出 于 安全 方面 的 考 
夸 ， 我 们 需要 提供 认证 信息 才能 访问 一 些 远程 仓库 。 例 如 ， 组 织 内 部 有 
一 个 Maven 仓 库 服 务 器 ， 该 服务 器 为 每 个 项 目 都 提供 独立 的 Maven 仓 
库 ， 为 了 防止 非法 的 仓库 访问 ， 管 理 员 为 每 个 仓库 提供 了 一 组 用 户 名 及 
密码 。 这 时 ， 为 了 能 让 Maven 访 问 仓库 内 容 ， 就 需要 配置 认证 信息 。 





配置 认证 信息 和 配置 仓库 信息 不 同 ， 仓 库 信 息 可 以 直接 配置 在 POM 
文件 中 ， 但 是 认证 信息 必须 配置 在 settings.xml 文 件 中 。 这 是 因为 POM 往 
往 是 被 提交 到 代码 仓库 中 供 所 有 成 员 访 问 的 ， 而 settings.xml 一 般 只 放 在 
本 机 。 因 此 ， 在 settings.xml 中 配置 认证 信息 更 为 安全 。 





假设 需要 为 一 个 id 为 my-proj 的 仓库 配置 认证 信息 ， 编 辑 settings.xml 
文件 见 代码 清单 6-3: 


代码 清单 6-3 ”在 settings.xml 中 配置 仓库 认证 信息 


<servers > 


ot v - ~ 
<id>my-proj </id> 
<username >repo-user < /username > 


rd >repo-pwd < /password > 





Maven 使 用 settings.xml 文 件 中 并 不 显而易见 的 servers 元 素 及 其 server 
子 元 素 配 置 仓库 认证 信息 。 代 码 清 单 6-3 中 该 仓库 的 认证 用 户 名 为 repo- 
user， 认 证 密码 为 repo-pwd。 这 里 的 关键 是 id 元 素 ，settings.xml 中 server 
元 素 的 id 必须 与 POM 中 需要 认证 的 repository 元 素 的 id 完全 一 致 。 换 句 话 
说 ， 正 是 这 个 id 将 认证 信息 与 仓库 配置 联系 在 了 一 起 。 





6.4.2 ”部 署 至 远程 仓库 


在 第 6.3.4 节 中 所 到， 私服 的 一 大 作用 是 部 闭 第 三 方 构件 ， 包 括 组 织 
内 部 生成 的 构件 以 及 一 些 无 法 从 外 部 仓库 直接 获取 的 构件 。 无 论 是 日 党 
开发 中 生成 的 构件 ， 还 是 正式 版 本 发 布 的 构件 ， 都 需要 部 普 到 仓库 中 ， 
供 其 他 团队 成 员 使 用 。 














Maven 除 了 能 对 项 目 进行 编译 、 测 试 、 打 包 之 外 ， 还 能 将 项 目 生成 
的 构建 部 署 到 仓库 中 。 首 先 ， 需 要 编辑 项 目的 pom.xml 文 件 。 配 置 
distributionManagement 元 素 见 代码 清单 6-4。 





代码 清单 6-4 在 POM 中 配置 构件 部 署 地 址 


<project > 


<distributionManagement > 
<repository > 
<id>proj-releases < /id> 
<name > Proj Release Repository < /name > 
<url >http://192.168.1.100 /content /repositories /proj-releases < /url > 
< f/repository > 


<snapshotRepository > 


<id>proj-si sts < /id> 
< name oj t Repository < /name 





CED: // .168. 
- Jananchnt annc AY R 
/snapshotReposLtory > 


< /distributionManagement > 


distributionManagement 包 含 repository 和 snapshotRepository 子 元 素 ， 





前 者 表示 发 布 版 本 构件 的 仓库 ， 后 者 表示 快照 版 本 的 仓库 。 关 于 发 布 版 
本 和 快照 版 本 ， 第 6.5 节 会 详细 解释 。 这 两 个 元 素 下 都 需要 配置 d、name 
和 url，id 为 该 远程 仓库 的 唯一 标识 ，name 是 为 了 方便 人 阅读 ， 关 键 的 rl 
表示 该 仓库 的 地 址 。 








往 远程 仓库 部 署 构 件 的 时 候 ， 往 往 需 要 认证 。 配 置 认 证 的 方式 已 在 
第 5.4 节 中 详细 阐述 ， 简 而 言 之 ， 就 是 需要 在 settings.xml 中 创建 一 个 
server 元 素 ， 其 id 与 仓库 的 id 匹配 ， 并 配置 正确 的 认证 信息 。 不 论 从 远程 
仓库 下 载 构件 ， 还 是 部 署 构 件 至 远程 仓库 ， 当 需要 认证 的 时 候 ， 配 置 的 
方式 是 一 样 的 。 





配置 正确 后 ， 在 命令 行 运行 mvn clean deploy，Maven 就 会 将 项 目 构 
建 输出 的 构件 部 著 到 配置 对 应 的 远程 仓库 ， 如 果 项 目 当 前 的 版 本 是 快照 
版 本 ， 则 部 署 到 快照 版 本 仓库 地 址 ， 人 否则 就 部 署 到 发 布 版 本 仓库 地 址 。 
如 下 是 部 署 一 个 快照 版 本 的 输出 : 


[INFO] --- maven-deploy-plugin:2.4:deploy (default-deploy) @ account-email -—— 
[INFO] Retr ng previous build number from proj-snapshots 

Uplo a 1g: 

http://192.168. 00 /content /repositories /proj-snapshots /com/juven /mvnbook / 


account /accou nt-email A. . 0-SNAPSHOT /account-email-1.0.0-2 
50936-2. ` meang 

loaded at 727.8 KB/sec 
INFO] Retrieving previous metadata from proj-snapshots 









INFO] Uploading repository metadata for: artifact com. juven.mvnbook.account :ac- 
couñt-email' 
NFO] Uploading project information for account-email 1.0.0-20100103.150936-2 
[INFO] Retrieving previous metadata from prog -snapshots 
INFO] Uploading repository metadata for:'snapshot com. juven.mvnbook. account :ac- 
count-emai 1 31.0: 0-SNAPSHOT’ 
NE see 


[INFO] BUILD SUCCESS 
二 





6.5 快照 版 本 


在 Maven 的 世界 中 ， 任 何 一 个 项 目 或 者 构件 都 必须 有 自己 的 版 本 。 
版 本 的 值 可 能 是 1.0.0、1.3-alpha-4、2.0、2.1-SNAPSHOT 或 者 2.1- 
20091214.221414-13。 其 中 ，1.0.0、1.3-alpha-4 和 2.0 是 稳定 的 发 布 版 
本 ， 而 2.1-SNAPSHOT 和 2.1-20091214.221414-13 是 不 稳定 的 快照 版 本 。 


Maven 为 什么 要 区 分 发 布 版 和 快照 版 呢 ? 简单 的 1.0.0、1.2、2.1 等 
不 就 够 了 吗 ? 为 什么 还 要 有 2.1-SNAPSHOT， 甚 至 是 长 长 的 2.1- 
20091214.221414-13? 试想 一 下 这 样 的 情况 ， 小 张 在 开发 模块 A 的 2.1 版 
本 ， 该 版 本 还 未 正式 发 布 ， 与 模块 A 一 同 开发 的 还 有 模块 B， 它 由 小 张 
的 同事 季 MM 开 发 ，B 的 功能 依赖 于 A。 在 开发 的 过 程 中 ， 小 张 需要 经 常 
将 自己 最 新 的 构建 输出 ， 交 给 季 MM， 供 她 开发 和 集成 调试 ， 问 题 是 
这 个 工作 如 何 进 行 呢 ? 








一 


让 季 MM 自 己 签 出 模块 A 的 源码 进行 构建 。 这 种 方法 能 够 确保 季 
MM 得 到 模块 A 的 最 新 构件 ， 不 过 她 不 得 不 去 构建 模块 A。 多 了 一 些 版 
本 控制 和 Maven 操 作 还 不 算 ， 当 构建 A 失 败 的 时 候 ， 她 会 是 一 头 邹 水 ， 
最 后 不 得 不 找 小 张 解决 。 显 然 ， 这 种 方式 是 低 效 的 。 


重复 部 署 模块 A 的 2.1 版 本 供 季 MM 下 载 。 虽 然 小 张 能 够 保证 仓库 中 
的 构件 是 最 新 的 ， 但 对 于 Maven 来 说 ， 同 样 的 版 本 和 同样 的 坐标 就 意味 
着 同样 的 构件 。 因 此 ， 如 果 季 MM 在 本 机 的 本 地 仓库 包含 了 模块 A 的 2.1 
版 本 构件 ，Maven 就 不 会 再 对 照 远 程 仓 库 进 行 更 新 。 除 非 她 每 次 执行 
Maven 命 令 之 前 ， 清 除 本 地 仓库 ， 但 这 种 要 求 手工 干预 的 做 法 显然 也 是 
不 可 取 的 。 


9 方案 三 


不 停 更 新 版 本 2.1.1、2.1.2、2.1.3......。 首 先 ， 小 张 和 季 MM 两 人 都 
需要 频繁 地 更 改 POM， 如 果 有 更 多 的 模块 依赖 于 模块 A， 就 会 涉及 更 多 
的 POM 更 改 ; 其 次 ， 大 量 的 版 本 其 实 仅仅 包含 了 微小 的 差异 ， 有 时 候 是 
对 版 本 号 的 波 








Maven 的 快照 版 本 机 制 就 是 为 了 解决 上 述 问题 。 在 该 例 中 ， 小 张 只 
需要 将 模块 A 的 版 本 设 定 为 2.1-SNAPSHOT， 然 后 发 布 到 私服 中 ， 在 发 
布 的 过 程 中 ，Maven 会 目 动 为 构件 打上 时 间 戳 。 比 如 2.1- 
20091214.221414-13 就 表示 2009 年 12 月 14 日 22 点 14 分 14 秒 的 第 13 次 快 
照 。 有 了 该 时 间 惟 ，Maven 惑 能 随时 找到 仓库 中 该 构件 2.1-SNAPSHOT 
版 本 最 新 的 文件 。 这 时 ， 季 MM 配置 对 于 模块 A 的 2.1-SNAPSHOT 版 本 
的 依赖 ， 当 她 构建 模块 B 的 时 候 ，Maven 会 自动 从 仓库 中 检查 模块 A 的 
2.1-SNAPSHOT 的 最 新 构件 ， 当 发 现 有 更 新 时 便 进行 下 载 。 默 认 情 况 
下 ，Maven 每 天 检查 一 次 更 新 (由 仓库 配置 的 updatePolicy 控 制 ， 见 第 


6.4 节 ) ， 用 户 也 可 以 使 用 命令 行 -U 参 数 强 制 让 Maven 检 和 查 更 新 ， 如 mvn 


clean install-U. 





基于 快照 版 本 机 制 ， 小 张 在 构建 成 功 之 后 才能 将 构件 部 车 至 仓库 ， 
而 季 MM 可 以 完全 不 用 考虑 模块 A 的 构建 ， 并 且 她 能 确保 随时 得 到 模块 
A 的 最 新 可 用 的 快照 构件 ， 而 这 一 切 都 不 需要 额外 的 手工 操作 。 


当 项 目 经 过 完善 的 测试 后 需要 发 布 的 时 候 ， 就 应 该 将 快照 版 本 更 改 
为 发 布 版 本 。 例 如 ， 将 2.1-SNAPSHOT 更 改 为 2.1， 表 示 该 版 本 已 经 稳 
定 ， 且 只 对 应 了 唯一 的 构件 。 相 比 之 下 ，2.1-SNAPSHOT 往 往 对 应 了 大 
量 的 带 有 不 同时 间 戳 的 构件 ， 这 也 决定 了 其 不 稳定 性 。 


快照 版 本 只 应 该 在 组 织 内 部 的 项 目 或 模块 间 依赖 使 用 ， 因 为 这 时 ， 
组 织 对 于 这 些 快照 版 本 的 依赖 具有 完全 的 理解 及 控制 权 。 项 目 不 应 该 依 
赖 于 任何 组 织 外 部 的 快照 版 本 依赖 ， 由 于 快照 版 本 的 不 稳定 性 ， 这 样 的 
依赖 会 造成 潜在 的 危险 。 也 就 是 说 ， 即 使 项 目 构 建 今天 是 成 功 的 ， 由 于 
外 部 的 快照 版 本 依赖 实际 对 应 的 构件 随时 可 能 变化 ， 项 目的 构建 就 可 能 
由 于 这 些 外 部 的 不 受 控制 的 因素 而 失败 。 





6.6 ”从 仓库 解析 依赖 的 机 制 





第 5 章 详 细 介 绍 了 Maven 的 依赖 机 制 ， 本 章 又 深入 阐述 了 Maven 仓 
库 ， 这 两 者 是 如 何 有 具体 联系 到 一 起 的 昵 ? Maven 是 根据 怎样 的 规则 从 仓 
库 解析 并 使 用 依赖 构件 的 呢 ? 





当 本 地 仓库 没有 依赖 构件 的 时 候 ，Maven 会 自动 从 远程 仓库 下 载 ; 
当 依 赖 版 本 为 快照 版 本 的 时 候 ，Maven 会 自动 找到 最 新 的 快照 。 这 背后 
的 依赖 解析 机 制 可 以 概括 如 下 : 


1) 当 依赖 的 范围 是 system 的 时 候 ，Maven 直 接 从 本 地 文件 系统 解析 
构件 。 


2) 根据 依赖 坐标 计算 仓库 路 径 后 ， 和 尝试 直接 从 本 地 仓库 寻找 构 
件 ， 如 宁 发 现 相 应 构件 ， 则 解析 成 功 。 





3) 在 本 地 仓库 不 存在 相应 构件 的 情况 下 ， 如 果 依 赖 的 版 本 是 显 式 
的 发 布 版 本 构件 ， 如 1.2、2.1-beta-1 等 ， 则 遍历 所 有 的 远程 仓库 ， 发 现 
后 ， 下 载 并 解析 使 用 。 


4) 如 果 依 赖 的 版 本 是 RELEASE 或 者 LATEST， 则 基于 更 新 策略 读 
取 所 有 远程 仓库 的 元 数据 groupId/artifactId/maven-metadata.xml， 将 其 与 
本 地 仓库 的 对 应 元 数据 合并 后 ， 计 算出 RELEASE 或 者 LATEST 真 实 的 





值 ， 然 后 基于 这 个 真实 的 值 检查 本 地 和 远程 仓库 ， 如 步骤 2) 和 3) 。 


5) 如 果 依 赖 的 版 本 是 SNAPSHOT， 则 基于 更 新 策略 读 取 所 有 远程 
仓库 的 元 数据 groupId/artifactId/version/maven-metadata.xml， 将 其 与 本 地 
仓库 的 对 应 元 数据 合并 后 ， 得 到 最 新 快照 版 本 的 值 ， 然 后 基于 该 值 检查 
本 地 仓库 ， 或 者 从 远程 仓库 下 载 。 








6) 如 果 最 后 解析 得 到 的 构件 版 本 是 时 间 惟 格式 的 快照 ， 如 1.4.1- 
20091104.121450-121， 则 复制 其 时 间 惟 格式 的 文件 至 非 时 间 戳 格式， 如 
SNAPSHOT， 并 使 用 该 非 时 间 惟 格式 的 构件 。 


当 依赖 的 版 本 不 明晰 的 时 候 ， 如 RELEASE、LATEST 和 
SNAPSHOT，Maven 束 需要 基于 更 新 远程 仓库 的 更 新 策略 来 检查 更 新 。 
在 第 6.4 节 提 到 的 仓库 配置 中 ， 有 一 些 配 置 与 此 有 关 : 首先 是 <releases> 
<enabled> 和 <snapshots><enabled>， 只 有 仓库 开启 了 对 于 发 布 版 本 的 支 
持 时 ， 才 能 访问 该 仓库 的 发 布 版 本 构件 信息 ， 对 于 快照 版 本 也 是 同 理 ; 
其 次 要 注意 的 是 <releases> 和 <snapshots> 的 子 元 素 <updatePolicy>， 该 元 
素 配 置 了 检查 更 新 的 频率 ， 每 日 检查 更 新 、 永 远 检查 更 新 、 从 不 检查 更 
新 、 自 定义 时 间 间 隔 检 查 更 新 等 。 最 后 ， 用 户 还 可 以 从 命令 行 加 入 参 
数 -U， 强 制 检查 更 新 ， 使 用 参数 后 ，Maven 就 会 忽略 <updatePolicy> 的 配 
置 。 























当 Maven 检 查 完 更 新 策略 ， 并 决定 检查 依赖 更 新 的 时 候 ， 就 需要 检 


查 仓 库 元 数据 maven-metadata.xml。 


回顾 一 下 前 面 提 到 的 RELEASE 和 LATEST 版 本 ， 它 们 分 别 对 应 了 仓 
库 中 存在 的 该 构件 的 最 新 发 布 版 本 和 最 新 版 本 (包含 快照 ) ， 而 这 两 
个 “最 新 ”是 基于 groupId/artifactId/maven-metadata.xml 计 算出 来 的 ， 见 代 
码 清 单 6-5。 











代码 清单 6-5 ”基于 groupId 和 artifactId 的 maven-metadata.xml 


<?xml version = "1.0" encoding = "UTF-8"?> 
<metadata > 


<groupid >org. sonatype. nexus < /grouplId > 








rsion > 





A e < #/ ino , 
>1.4,0-SNAPSHOT < /version > 





< /metadata > 





该 XML 文件 列 出 了 仓库 中 存在 的 该 构件 所 有 可 用 的 版 本 ， 同 时 
latest 元 素 指 向 了 这 些 版 本 中 最 新 的 那个 版 本 ， 该 例 中 是 1.4.2- 
SNAPSHOT. 而 release 元 素 指 向 了 这 些 版 本 中 最 新 的 发 布 版 本 ， 该 例 中 
是 1.4.0。Maven 通 过 合并 多 个 远程 仓库 及 本 地 仓库 的 元 数据 ， 就 能 计算 
出 基于 所 有 仓库 的 latest 和 和 release 分 别 是 什么 ， 然 后 再 解析 具体 的 构件 。 











需要 注意 的 是 ， 在 依赖 声明 中 使 用 LATEST 和 RELEASE 是 不 推荐 的 
做 法 ， 因 为 Maven 随 时 都 可 能 解析 到 不 同 的 构件 ， 可 能 今天 LATEST 是 
1.3.6， 明 天 就 成 为 1.4.0-SNAPSHOT 了 ， 且 Maven 不 会 明确 告诉 用 户 这 
样 的 变化 。 当 这 种 变化 造成 构建 失败 的 时 候 ， 发 现 问题 会 变 得 比较 困 
难 。RELEASE 因 为 对 应 的 是 最 新 发 布 版 构建 ， 还 相对 可 靠 ，LATEST 就 
非常 不 可 靠 了 ， 为 此 ，Maven 3 不 再 文 持 在 插件 配置 中 使 用 LATEST 和 
RELEASE。 如 果 不 设 置 插件 版 本 ， 其 效果 就 和 RELEASE 一 样 ，Maven 
只 会 解析 最 新 的 发 布 版 本 构件 。 不 过 即使 这 样 ， 也 还 存在 潜在 的 问题 。 
例如 ， 某 个 依赖 的 1.1 版 本 与 1.2 版 本 可 能 发 生 一 些 接口 的 变化 ， 从 而 导 
致 当前 Maven 构 建 的 失败 。 


当 依 赖 的 版 本 设 为 快照 版 本 的 时 候 ，Maven 也 需要 检查 更 新 ， 这 


时 ，Maven 会 检查 仓库 元 数据 groupIdy/artifactId/version/maven- 








metadata.xml， 见 代码 清单 6-6。 


代码 清单 6-6 ”基于 groupId、artifactId 和 version 的 maven- 


metadata.xml 


<?xml version = "1.0" encoding = "UTF-8"?> 
<metadata > 





该 XML 文件 的 snapshot 元 素 包 含 了 timestamp 和 buildNumber 两 个 子 
元 素 ， 分 别 代 表 了 这 一 快照 的 时 间 惟 和 构建 号 ， 基 于 这 两 个 元 素 可 以 得 
到 该 仓库 中 此 快照 的 最 新 构件 版 本 实际 为 1.4.2-20091214.221414-13。 通 
过 合并 所 有 远程 仓库 和 本 地 仓库 的 元 数据 ，Maven 就 能 知道 所 有 仓库 中 
该 构件 的 最 新 快照 。 











最 后 ， 仓 库 元 数据 并 不 是 永远 正确 的 ， 有 时 候 当 用 户 发 现 无 法 解析 
东 些 构件 ， 或 者 解析 得 到 错误 构件 的 时 候 ， 就 有 可 能 是 出 现 了 仓库 元 数 
据 错误 ， 这 时 束 需 要 手工 地 ， 或 者 使 用 工具 (如 Nexus) 对 其 进行 修 
复 。 











6.7 镜像 


如 果 仓 库 X 可 以 提供 仓库 Y 存 储 的 所 有 内 容 ， 那 么 就 可 以 认为 X 是 Y 





的 一 个 镜像 。 换 句 话 说， 任何 一 个 可 以 从 仓库 Y 获 得 的 构件 ， 都 能 够 从 
它 的 镜像 中 获取 。 举 个 例子 ，http://maven.net.cn/content/groups/public/ 是 
中 央 仓 库 http://repol.maven.org/maven2/ 在 中 国 的 镜像 ， 由 于 地 理 位 置 的 
因素 ， 该 镜像 往往 能 够 提供 比 中 央 仓 库 更 快 的 服务 。 因 此 ， 可 以 配置 

Maven 使 用 该 镜像 来 蔡 代 中 央 仓库 。 编 辑 settings.xml， 见 代码 清单 6-7。 


像 ， 


代码 清单 6-7 配置 中 央 仓库 镜像 


<mirrors> 
<mirror > 
<id>maven.net.cn</id> 
<name >one of the central mirrors in China < /name > 
<url >http://maven.net.cn/content /groups /public/ < /url > 
<cmirrorOf >central < /mirrorOf > 
< /mirror > 


</mirrors > 


< /settings > 


该 例 中 ，<mirrorOf> 的 值 为 central， 表 示 访 配置 为 中 央 仓 库 的 镜 
任何 对 于 中 央 仓 库 的 请 求 都 会 转 至 该 镜像 ， 用 户 也 可 以 使 用 同样 的 


方法 配置 其 他 仓库 的 镜像 。 另 外 三 个 元 素 id、name、ur 与 一 般 仓库 配置 
无 寞 ， 表 示 该 镜像 仓库 的 唯一 标识 符 、 名 称 以 及 地 址 。 类 似 地 ， 如 果 该 
镜像 需要 认证 ， 也 可 以 基于 该 id 配置 仓库 认证 。 


关于 镜像 的 一 个 更 为 常见 的 用 法 是 结合 私服 。 由 于 私服 可 以 代理 任 
何 外 部 的 公共 仓库 (包括 中 央 仓 库 ) ， 因 此 ， 对 于 组 织 内 部 的 Maven 用 
己 来 说 ， 使 用 一 个 私服 地 址 就 等 于 使 用 了 所 有 需要 的 外 部 仓库 ， 这 可 以 
将 配置 集中 到 私服 ， 从 而 简化 Maven 本 身 的 配置 。 在 这 种 情况 下 ， 任 何 
再 要 的 构件 都 可 以 从 私服 获得 ， 私 服 就 是 所 有 仓库 的 镜像 。 这 时 ， 可 以 
配置 这 样 的 一 个 镜像 ， 见 代码 清单 6-8。 








代码 清单 6-8 配置 使 用 私服 作为 镜像 


<settings > 
<mirrors > 
<mirror > 
<id>internal+epository < /id> 
<name >Internal Repository Manager < /name > 
<url >http://192.168.1.100/maven2 /< /url > 


<mirrorof > * < /mirrorof > 
< /mirror > 
< /mirrors > 


< /settings > 





该 例 中 <mirrorOf> 的 值 为 星 写 ， 表 示 该 配置 是 所 有 Maven 仓 库 的 镜 
像 ， 任 何 对 于 远程 仓库 的 请 求 都 会 被 转 至 http:/192.168.1.100/maven2/。 
如 果 访 镜像 仓库 需要 认证 ， 则 配置 一 个 id 为 internal-repository 的 <server> 


即 可 ， 详 见 第 5.4 节 。 
为 了 满足 一 些 复杂 的 需求 ，Maven 还 支持 更 高 级 的 镜像 配置 : 


:<mirrorOf>*</mirrorOf>: [匹配 所 有 远程 仓库 。 


-<mirrorOf>external: *</mirrorOf>: 匹配 所 有 远程 仓库 ， 使 用 
localhost 的 除外 ， 使 用 名 e: /协议 的 除外 。 也 就 是 说 ， 匹 配 所 有 不 在 本 
机 上 的 远程 仓库 。 


-<mirrorOf>repol, repo2</mirrorOf>: 匹配 仓库 repo1 和 repo2， 使 用 


逗号 分 隅 多 个 远程 仓库 。 


(i 





<mirrorOf>*，! repol</mirrorOf>: 匹配 所 有 远程 仓库 ，repol 除 
外 ， 使 用 感叹 号 将 仓库 从 匹配 中 排除 。 











再 要 注意 的 是 ， 由 于 镜像 仓库 完全 屏蔽 了 被 镜像 仓库 ， 当 镜像 仓库 
不 稳定 或 者 停止 服务 的 时 候 ，Maven 仍 将 无 法 访问 被 镜像 仓库 ， 因 而 将 
无 法 下 载 构件 。 


6.8 仓库 搜索 服务 





使 用 Maven 进 行 日 党 开发 的 时 候 ， 一 个 常见 的 问题 就 是 如 何 寻找 需 
要 的 依赖 ， 我 们 可 能 只 知道 需要 使 用 类 库 的 项 目 名 称 ， 但 添加 Maven 依 
赖 要 求 提 供 确 切 的 Maven 坐 标 。 这 时 ， 就 可 以 使 用 仓库 搜索 服务 来 根据 
关键 字 得 到 Maven 坐 标 。 本 节 介绍 几 个 常用 的 、 功 能 强大 的 公共 Maven 
仓库 搜索 服务 。 


6.8.1 Sonatype Nexus 


地 址 : http://repository.sonatype.org/ 








Nexus 是 当前 最 流行 的 开源 Maven 仓 库 管理 软件 ， 本 书后 面 会 有 专 
门 的 章节 讲述 如 何 使 用 Nexus 假 设 私 服 。 这 里 要 介绍 的 是 Sonatype 架 设 
的 一 个 公共 Nexus 仓 库 实例 。 


Nexus 提 供 了 关键 字 搜 索 、 类 名 搜索 、 坐 标 搜索 、 校 验 和 搜索 等 功 
能 。 搜 索 后 ， 页 面 清晰 地 列 出 了 结果 构件 的 坐标 及 所 属 仓库 。 用 户 可 以 
直接 下 载 相 应 构件 ， 还 可 以 直接 复制 已 经 根据 坐标 自动 生成 的 XML 依 
赖 声 明 ， 见 图 6-3。 
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Sonatype™ Servers | | Welcome =| Search z 
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Artifact Search al Artifact Version Download 
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Z Refresh | Viewing Repository: | Central Pro. | Maven Information | Artfact Informaton | Artifact Metadata | Archive Browser | 
sane “cup aera 
四 3. 
四 图 32 Artfact: activerng 
(gg EESK Version: 4.0443 
8 器 321 Extension: Jar 
wg 3.2.2 
a@m223 XML: <dependency> 
324 <groupld>activemq</groupid> 
a (3 <artifactidactivema</artifactid> 
(gg 40M <version>4.0-43</version> 
(gy 4.0-M2 } </dependency> 
Bg 40-3 
(Rp activemg-4.0443 jar 
i (gg felease-1.1-G1M3 
B (qi release-1 2 
m (gqrelease-1.3 
w (gy release-1.4 
@(qrelease-15 
(gj release-20 J 
ee eee NRR Bed 


图 6-3 Sonatype Nexus 仓 库 搜 索 服 务 





6.8.2 Jarvana 


地 址 : http://www.jarvana.com/jarvana/ 





Jarvana 提 供 了 基于 关键 字 、 类 名 的 搜索 ， 构 件 下 载 、 依 赖 声 明 片 段 
等 功能 也 一 应 俱全 。 值 得 一 提 的 是 ，Jarvana 还 文 持 浏览 构件 内 部 的 内 
容 。 此 外 ，Jarvana 还 提供 了 便捷 的 Java 文 档 浏览 的 功能 。Jarvana 的 搜索 
结果 页 面 如 图 6-4 所 示 。 





Search Browse JavadocsNEW More 


JARVANA fso ion iol 


Project Search: Results 1 - 100 of 559 for "activemq". 
Result Page: 1 23456 


View: Dependency | Path 

# 国 思 ar 向 Archive Details Group Id Artifact Id 
1 & & 4) © activema-release-2.1.jar A activemg + activemq 

2 & & a Y activema-release-2.0.jar activemq activemq 

3 Æ a ae) © activemg-release-1.5.jar activemq activemq 


4 & a) ao T activemg-release-1.4.jar activemq —_activemq 

5 St & aa) © activemg-release-1.3.jar activemq activemq 

6 & &) a) T activemg-release-1.2,jar activemg activemq 

7 4 & 4} = activemg-release-1.1-G1M3.jar activemq activemq release-1.1-G1M3 
s et es) an i .0-M3. activemq activemq 4.0-M3 
9 8a activemg-4.0-M2.jar activemq activemgq 4.0-M2 
10 & j 40) adivemq-40MLjar activemq activemq 

11 GH aa activemg-3.2.4.jar activemq activemq 

12 Æ a és) activemq-3.2.3.jar activemg activemg 

13 ost é a activemg-3.2.2.jar activemq activemq 

14 & a ëd activemg-3.2.1.,jar activemq activemq 

15 ast i Ez 全 activemg-3.2-M1l.jar activemg activemgq 

16 GH aa) 601 ivemg-3.2,jar activemg _activema 


图 6-4 ”Jarvana 仓 库 搜索 服务 














6.8.3 MVNbrowser 


地 址 : http://www.mvnbrowser.com 





MVNbrowser 只 提供 关键 字 搜 索 的 功能 ， 除 了 提供 基于 坐标 的 依赖 
声明 代码 片段 等 基本 功能 之 外 ，MVNbrowser 的 一 大 特色 就 是 ， 能 够 告 
诉 用 户 该 构件 的 依赖 于 其 他 哪些 构件 (Dependencies〉 以 及 该 构件 被 哪 
些 其 他 构件 依赖 (Referenced By) ， 如 图 6-5 所 示 。 
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Pom snippet 


<dependency> 
<qroupl d>activemg</groupld> 
¢artifactid>activemy</artifactiId> 
<version>4.0-M3</versicn> 
</dependency> 
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图 6-5 MVNbrowser 仓 库 搜索 服务 


Versions Dependencies Files [Reterenced By | Repositones Licenses 


Plugins 


Tutorial 














6.8.4 MVNrepository 


地 址 : http://mvnrepository.com/ 


MVNrepository 的 界面 比较 清新 ， 它 提供 了 基于 关键 字 的 搜索 、 依 
赖 声 明 代码 片段 、 构 件 下 载 、 依 赖 与 被 依赖 天 系 信息 、 构 件 所 舍 包 信息 
等 功能 。MVNrepository 还 能 提供 一 个 简单 的 图 表 ， 显 示 茶 个 构件 各 版 
本 间 的 大 小 变化 。MVNrepository 的 页 面 如 图 6-6 所 示 。 
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图 6-6 MVNrepository 仓 库 搜 索 服 务 


6.8.5 选择 合适 的 仓库 搜索 服务 


上 述 介绍 的 四 个 仓库 搜索 服务 部 代理 了 主流 的 Maven 公 共 仓 库 ， 如 
central、JBoss、Java.net 等 。 这 些 服务 部 提供 了 完备 的 搜索 、 浏 览 、 
载 等 功能 ， 区 别 只 在 于 页 面 风格 和 额外 功能 。 例 如 ，Nexus 提 供 了 其 他 
三 种 服务 所 没有 的 基于 校 验 和 搜索 的 功能 。 用 户 可 以 根据 喜好 和 特殊 需 
要 选择 最 合适 自己 的 搜索 服务 ， 当 然 ， 也 可 以 综合 使 用 所 有 这 些 服务 。 











6.9 ”小 结 





本 章 深 入 阐述 了 仓库 这 一 Maven 核 心 概念 。 首 先 介绍 了 仓库 的 由 
来 ;接着 直接 训 析 了 一 段 Maven 源 码 ， 介 绍 仓库 的 布局 ， 以 方便 读者 将 
仓库 与 实际 文件 联系 起 来 ， 而 仓库 的 分 类 这 一 部 分 则 分 别 介绍 了 本 地 仓 
库 、 远 程 仓库 、 中 央 仓 库 以 及 私服 等 概念 ; 基于 这 些 概念 ， 叉 详细 介绍 
了 仓库 的 配置 ， 在 此 基础 上 ， 我 们 再 深入 仓库 的 内 部 工作 机 制 ， 并 同时 
解释 了 Maven 中 快照 的 概念 。 本 章 还 解释 了 镜像 的 概念 及 用 法 。 最 后 ， 
本 章 介 绍 了 一 些 和 用 的 仓库 搜索 服务 ， 以 方便 读者 的 日 铝 开 发 工作 。 








第 7 革 ”生命 周期 和 插件 
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除了 坐标 、 依 赖 以 及 仓库 之 外 ，Maven 另 外 两 个 核心 概念 是 生命 周 
期 和 插件 。 在 有 关 Maven 的 日 常 使 用 中 ， 命 令 行 的 输入 往往 就 对 应 了 生 
命 周 期 ， 如 mvn package 就 表示 执行 默认 生命 周期 阶段 package。Maven 
的 生命 周期 是 抽象 的 ， 其 实际 行为 都 由 插件 来 完成 ， 如 package 阶 段 的 


任务 可 能 束 会 由 maven-jar-plugin 完 成 。 生 命 周 期 和 插件 两 者 协同 工作 ， 
密 不 可 分 ， 本 章 对 它们 进行 深入 介绍 。 


7.1 何 为 生命 周期 





在 Maven 出 现 之 前 ， 项 目 构 建 的 生命 周期 就 已 经 存在 ， 软 件 开 及 人 
员 每 天 都 在 对 项 目 进行 清理 、 编 译 、 测 试 及 部 署 。 虽 然 大 家 都 在 不 停 地 
做 构建 工作 ， 但 公司 和 公司 间 、 项 目 和 项 目 间 ， 往 往 使 用 不 同 的 方式 做 
类 似 的 工作 。 有 的 项 目 以 手工 的 方式 在 执行 编译 测试 ， 有 的 项 目 写 了 自 
动 化 脚本 执行 编译 测试 。 可 以 想象 的 是 ， 虽 然 各 种 手工 方式 十 分 类 似 ， 
但 不 可 能 完全 一 样 ， 同 样 地 ， 对 于 目 动 化 脚本 ， 大 家 也 是 各 写 各 的 ， 能 
满足 目 身 需求 即 可 ， 换 个 项 目 吏 需要 重头 再 来 。 














Maven 的 生命 周期 就 是 为 了 对 所 有 的 构建 过 程 进 行 抽象 和 统一 。 
Maven 从 大 量 项 目 和 构建 工具 中 学 习 和 反思 ， 然 后 站 结 了 一 套 高 度 完善 
的 、 易 扩展 的 生命 周期 。 这 个 生命 周期 包含 了 项 目的 清理 、 初 始 化 、 纺 
译 、 测 试 、 打 包 、 集 成 测试 、 验 证 、 部 署 和 站 点 生成 等 几乎 所 有 构建 步 
又 。 也 惑 是 说 ， 几 乎 所 有 项 目的 构建 ， 都 能 映射 到 这 样 一 个 生命 周期 








Maven 的 生命 周期 是 抽象 的 ， 这 意味 着 生命 周期 本 和 喘 不 做 任何 实际 
的 工作 ， 在 Maven 的 设计 中 ， 实 际 的 任务 (如 编译 源 代码 〉 都 交 由 插件 
来 完成 。 这 种 思想 与 设计 模式 中 的 模板 方法 (Template Method) 非常 相 
似 。 模 板 方法 模式 在 父 类 中 定义 算法 的 整体 结构 ， 子 类 可 以 通过 实现 或 
者 重 写 父 类 的 方法 来 控制 实际 的 行为 ， 这 样 既 保证 了 算法 有 足够 的 可 扩 








展 性 ， 


又 能 够 严格 控制 算法 的 整体 结构 。 如 下 的 模板 方法 抽象 类 能 够 很 


好 地 体现 Maven 生 命 周期 的 概念 ， 见 代码 清单 7-1。 


代码 清单 7-1 模拟 生命 周期 的 模板 方法 抽象 类 


Dackage com. juvenxu.mvnbook. template. method; 
public abstract class AbstractBuild 
public void build () 
initialize(); 
compile (); 
test (); 
packagee (); 
integrationTest (); 
deploy (); 
protect abstract void initialize(); 
protected abstract void compile (); 
protected abstra void test (); 
protected abstra void packagee (}; 
prot ed abstract void integrationTest (); 
protected abstra void deploy (); 


这 段 代码 非常 简单 ，build() 方法 定义 了 整个 构建 的 过 程 ， 依 次 初 
始 人 化、 编译、 测试 、 打 包 〈 由 于 package 与 Java 关 键 字 冲突 ， 这 里 使 用 了 
单词 packagee) 、 集 成 测试 和 部 署 ， 但 是 这 个 类 中 没有 具体 实现 初始 
化 、 编 译 、 测 试 等 行为 ， 它 们 都 交 由 子 类 去 实现 。 


虽然 上 述 代 码 和 Maven 实 际 代码 相去 其 远 ，Maven 的 生命 周期 包含 
更 多 的 步骤 和 更 复杂 的 逻辑 ， 但 它们 的 基本 理念 是 相同 的 。 生 命 周 期 抽 
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谁 来 实现 这 些 步骤 呢 ? 不 能 让 用 户 为 了 编译 而 写 一 堆 代 码 ， 为 了 测试 又 
写 一 堆 代 码 ， 那 不 就 成 了 大 家 在 重复 发 明 轮 子 吗 ?Maven 当 然 必须 考虑 
这 一 点 ， 因 此 它 设 计 了 插件 机 制 。 每 个 构建 步骤 都 可 以 绑 定 一 个 或 者 多 
个 插件 行为 ， 而 且 Maven 为 大 多 数 构建 步骤 编写 并 绑 定 了 默认 插件 。 例 
如 ， 针 对 编译 的 插件 有 maven-compiler-plugin， 针 对 测试 的 插件 有 

maven-surefire-plugin 等 。 虽 然 在 大 多 数 时 间 里 ， 用 户 几 乎 都 不 会 觉察 到 
插件 的 存在 ， 但 实际 上 编译 是 由 maven-compiler-plugin 完 成 的 ， 而 测试 
是 由 maven-surefire-plugin 完 成 的 。 当 用 户 有 特殊 需要 的 时 候 ， 也 可 以 配 
置 插件 定制 构建 行为 ， 甚 至 自己 编写 插件 。 生 命 周期 和 插件 的 关系 如 图 
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maven-compiler-plugin maven-surefire-plugin 
图 7-1 生命 周期 和 插件 的 关系 


Maven 定 义 的 生命 周期 和 插件 机 制 一 方面 保证 了 所 有 Maven 项 目 有 
一 致 的 构建 标准 ， 力 一 方面 又 通过 默认 插件 简化 和 稳定 了 实际 项 目的 构 
建 。 此 外 ， 该 机 制 还 提供 了 足够 的 扩展 空间 ， 用 户 可 以 通过 配置 现 有 插 
件 或 者 目 行 编写 插件 来 自 定 义 构 建行 为 。 





7.2 生命 周期 详解 


到 目前 为 止 ， 本 书 只 是 介绍 了 Maven 生 命 周 期 背后 的 指导 思想 ， 要 
想 熟 练 地 使 用 Maven， 还 必须 详细 了 解 其 生命 周期 的 具体 定义 和 使 用 方 
To 


7.2.1 三 套 生 命 周 期 


初学 者 往往 会 以 为 Maven 的 生命 周期 是 一 个 整体 ， 其 实 不 然 ， 
Maven 拥 有 三 套 相 互 独立 的 生命 周期 ， 它 们 分 别 为 clean、default 和 site。 
clean 生 命 周 期 的 目的 是 清理 项 目 ，default 生 命 周期 的 目的 是 构建 项 目 ， 
而 site 生 命 周 期 的 目的 是 建立 项 目 站 点 。 








每 个 生命 周期 包含 一 些 阶段 (phase) ， 这 些 阶段 是 有 顺序 的 ， 并 
且 后 面 的 阶段 依赖 于 前 面 的 阶段 ， 用 户 和 Maven 最 直接 的 交互 方式 就 是 
调用 这 些 生命 周期 阶段 。 以 clean 生 命 周 期 为 例 ， 它 包含 的 阶段 有 pre- 
clean、clean 和 post-clean。 当 用 户 调用 pre-clean 的 时 候 ， 只 有 pre-clean 阶 
段 得 以 执行 ， 当 用 户 调用 clean 的 时 候 ，pre-clean 和 clean 阶 段 会 得 以 顺序 
执行 ， 当 用 户 调用 post-clean 的 时 候 ，pre-clean、clean 和 post-clean 会 得 以 
顺序 执行 。 








较 之 于 生命 周期 阶段 的 前 后 依赖 关系 ， 三 套 生 命 周 期 本 身 是 相互 独 
立 的， 用 户 可 以 仅仅 调用 clean 生 命 周期 的 某 个 阶段 ， 或 者 仅仅 调用 
default 生 命 周期 的 某 个 阶段 ， 而 不 会 对 其 他 生命 周期 产生 任何 影响 。 例 
如 ， 当 用 户 调用 clean 生 命 周 期 的 clean 阶 段 的 时 候 ， 不 会 触发 default 生 命 
周期 的 任何 阶段 ， 反 之 亦 然 ， 当 用 户 调用 default 生 命 周 期 的 compile 阶 段 
的 时 候 ， 也 不 会 触发 clean 生 命 周 期 的 任何 阶段 。 


7.2.2 clean 生命 周期 


clean 生 命 周期 的 目的 是 清理 项 目 ， 它 包含 三 个 阶段 : 
1) pre-clean 执 行 一 些 清理 前 需要 完成 的 工作 。 
2) clean 清 理 上 一 次 构建 生成 的 文件 。 


3) post-clean 执 行 一 些 清理 后 需要 完成 的 工作 。 





7.2.3 default 生命 周期 


default 生 命 周期 定义 了 真正 构建 时 所 需要 执行 的 所 有 步骤 ， 它 是 所 
有 生命 周期 中 最 核心 的 部 分 ， 其 包含 的 阶段 如 下 ， 这 里 笔者 只 对 重要 的 


阶段 进行 解释 : 
«validate 
-initialize 


“generate-sources 





:process-sources 处 理 项 目 主 资源 文件 。 一 般 来 说 ， 是 对 
src/main/resources 目 录 的 内 容 进 行 变 量 蔡 换 等 工作 后 ， 复 制 到 项 目 输出 
的 主 classpath 目 录 中 。 


“generate-resources 
*process-resources 


compile 编 译 项 目的 主 源码 。 一 般 来 说 ， 是 编译 src/main/java 目 录 下 
的 Java 文 件 至 项 目 输出 的 主 classpath 目 录 中 。 


‘process-classes 


‘generate-test-sources 


.process-test-sources 处 理 项 目测 试 资源 文件 。 一 般 来 说 ， 是 对 
src/test/resources 目 录 的 内 容 进行 变量 蔡 换 等 工作 后 ， 复 制 到 项 目 输出 的 
测试 classpath 目 录 中 。 


‘generate-test-resources 


‘process-test-resources 





test-compile 编 译 项 目的 测试 代码 。 一 般 来 说 ， 是 编译 src/test/java 晶 
录 下 的 Java 文 件 至 项 目 输出 的 测试 classpath 目 录 中 。 


‘process-test-classes 

test 使 用 单元 测试 框架 运行 测试 ， 测 试 代码 不 会 外 打包 或 部 普 。 
‘prepare-package 

:package 接 受 编译 好 的 代码 ， 打 包 成 可 发 布 的 格式 ， 如 JAR。 
‘pre-integration-test 

“integration-test 


“post-integration-test 


‘verify 
"install 将 包 安 装 到 Maven 本 地 仓库 ， 供 本 地 其 他 Maven 项 目 使 用 。 


:deploy 将 最 终 的 包 复 制 到 远程 仓库 ， 供 其 他 开发 人 员 和 Maven 项 目 
使 用 。 


对 于 上 述 未 加 解释 的 阶段 ， 读 者 也 应 该 能 够 根据 名 字 大 概 猜 到 其 用 
途 ， 石 想 了 解 进一步 的 这 些 阶 段 的 详细 信息 ， 可 以 参阅 官方 的 解 
释 : http://maven.apache.org/guides/introduction/introduction-to-the- 


lifecycle.html。 


7.2.4 site 生命 周期 





site 生 命 周 期 的 目的 是 建立 和 发 布 项 目 站 点 ，Maven 能 够 基于 POM 
所 包含 的 信息 ， 上 自动 生成 一 个 友好 的 站 点 ， 方 便 团 队 交 流 和 发 布 项 目 信 
晨 。 该 生命 周期 包含 如 下 阶段 : 











:pre-site 执 行 一 些 在 生成 项 目 站 点 之 前 需要 完成 的 工作 。 





site 生成 项 目 站 反 文 档 。 








:post-site 执 行 一 些 在 生成 项 目 站 点 之 后 需要 完成 的 工作 。 





“site-deploy 将 生成 的 项 目 站 点 发 布 到 服务 器 上 。 








命令 行 执 行 Maven 任 务 的 最 主要 方式 就 是 调用 Maven 的 生命 周期 

需要 注意 的 是 ， 各 个 生命 周期 是 相互 独立 的 ， 而 一 个 生命 周期 的 
阶段 是 有 前 后 依赖 关系 的 。 下 面 以 一 些 常 见 的 Maven 命 令 为 例 ， 解 释 其 
执行 的 生命 周期 阶段 : 


-$mvnclean: 该 命令 调用 clean 生 命 周 期 的 clean 阶 段 。 实 际 执行 的 
阶段 为 dean 生 命 周 期 的 pre-clean 和 clean 阶 段 。 


-$ mvn test: 该 命令 调用 default 生 命 周 期 的 test 阶 段 。 实 际 执行 的 阶 
段 为 default 生 命 周 期 的 validate、initialize 等 ， 直 到 test 的 所 有 阶段 。 这 也 
解释 了 为 什么 在 执行 测试 的 时 候 ， 项 目的 代码 能 够 自动 得 以 编译 。 





-$mvn clean install: 该 命令 调用 clean 生 命 周 期 的 clean 阶 段 和 default 
生命 周期 的 install 阶 段 。 实 际 执行 的 阶段 为 dean 和 生命 周期 的 pre-clean、 
clean 阶 段 ， 以 及 default 牛 命 周 期 的 从 validate 至 install 的 所 有 阶段 。 该 命 
令 结合 了 两 个 生命 周期 ， 在 执行 真正 的 项 目 构建 之 前 清理 项 目 是 一 个 很 
好 的 实践 。 





.$mvn clean deploy site-deploy: 该 命令 调用 clean 生 命 周 期 的 clean 
阶段 、default 生 命 周期 的 deploy 阶 段 ， 以 及 site 生 命 周 期 的 Site-deploy 阶 


段 。 实 际 执行 的 阶段 为 clean 生 命 周期 的 pre-clean、clean 阶 段 ，default 生 
命 周 期 的 所 有 阶段 ， 以 及 site 生 命 周 期 的 所 有 阶段 。 该 命令 结合 了 Maven 
所 有 三 个 生命 周期 ， 且 deploy 为 default 生 命 周 期 的 最 后 一 个 阶段 ，site- 
deploy 为 site 生 命 周 期 的 最 后 一 个 阶段 。 


由 于 Maven 中 主要 的 生命 周期 阶段 并 不 多 ， 而 和 常用 的 Maven 命 令 实 
际 都 是 基于 这 些 阶段 简单 组 合 而 成 的 ， 因 此 只 要 对 Maven 生 命 周 期 有 一 
个 基本 的 理解 ， 读 者 就 可 以 正确 而 熟练 地 使 用 Maven 命 令 。 


7.3 插件 目标 


在 进一步 详 述 插件 和 生命 周期 的 绑 定 关系 之 前 ， 必 须 先 了 解 插件 目 
标 (Plugin Goal) 的 概念 。 我 们 知道 ，Maven 的 核心 仅仅 定义 了 抽象 的 
生命 周期 ， 具 体 的 任务 是 交 由 插件 完成 的 ， 插 件 以 独立 的 构件 形式 存 
在 ， 因 此 ，Maven 核 心 的 分 发 包 只 有 不 到 3MB 的 大 小 ，Maven 会 在 需要 
的 时 候 下 载 并 使 用 插件 。 


对 于 插件 本 身 ， 为 了 能 够 复 用 代码 ， 它 往往 能 够 完成 多 个 任务 。 例 
如 maven-dependency-plugin， 它 能 够 基于 项 目 依 赖 做 很 多 事情 。 它 能 够 
分 析 项 目 依 赖 ， 帮 助 找 出 潜在 的 无 用 依赖 ， 它 能 够 列 出 项 目的 依赖 树 ， 
帮助 分 析 依 赖 来 源 ， 它 能 够 列 出 项 目 所 有 已 解析 的 依赖 ， 等 等 。 为 每 个 
这 样 的 功能 编写 一 个 独立 的 插件 显然 是 不 可 取 的 ， 因 为 这 些 任务 背后 有 
很 多 可 以 复 用 的 代码 ， 因 此 ， 这 些 功 能 聚集 在 一 个 插件 里 ， 每 个 功能 就 
是 一 个 插件 目标 。 





maven-dependency-plugin 有 十 多 个 目标 ， 每 个 目标 对 应 了 一 个 功 
能 ， 上 述 提 到 的 几 个 功能 分 别 对 应 的 插件 目标 为 dependency: analyze. 
dependency: tree 和 dependency: list。 这 是 一 种 通用 的 写法 ， 冒 号 前 面 
是 插件 前 级 ， 冒 号 后 面 是 该 插件 的 目标 。 类 似 地 ， 还 可 以 写 出 
compiler: compile 〈 这 是 maven-compiler-plugin 的 compile 目 标 ) 和 


surefire: test (这 是 maven-surefire-plugin 的 test 目 标 ) o 


7.4 插件 绑 定 


Maven 的 生命 周期 与 插件 相互 绑 定 ， 用 以 完成 实际 的 构建 任务 。 有 具 
体 而 言 ， 是 生命 周期 的 阶段 与 插件 的 目标 相互 绑 定 ， 以 完成 某 个 具体 的 
构建 任务 。 例 如 项 目 编译 这 一 任务 ， 它 对 应 了 default 生 命 周期 的 compile 
这 一 阶段 ， 而 maven-compiler-plugin 这 一 插件 的 compile 目 标 能 够 完成 该 


任务 。 因 此 ， 将 它们 绑 定 ， 就 能 实现 项 目 编译 的 目的 ， 如 图 7-2 所 示 。 
















default 


Compe ) maven-compiler-plugin 


= 
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为 了 能 让 用 户 几 乎 不 用 任何 配置 就 能 构建 Maven 项 目 ，Maven 在 核 
心 为 一 些 主要 的 生命 周期 阶段 绑 定 了 很 多 插件 的 目标 ， 当 用 户 通 过 命令 
行 调 用 生命 周期 阶段 的 时 候 ， 对 应 的 插件 目标 就 会 执行 相应 的 任务 。 


clean 生 命 周期 仅 有 pre-clean、clean 和 post-clean 三 个 阶段 ， 其 中 的 
clean 与 maven-clean-plugin: clean 绑 定 。maven-clean-plugin 仅 有 clean 这 
一 个 目标 ， 其 作用 就 是 删除 项 目的 输出 目录 。clean 生 命 周 期 阶段 与 插件 
目标 的 绑 定 关系 如 表 7-1 所 示 。 


site 生 命 周 期 有 pre-site、site、post-site 和 site-deploy 四 个 阶段 ， 其 
中 ，site 和 maven-site-plugin: site 相 互 绑 定 ，site-deploy 和 maven-site- 
plugin: depoy 相 互 绑 定 。maven-site-plugin 有 很 多 目标 ， 其 中 ，site 目 标 
用 来 生成 项 目 站 点 ，deploy 目 标 用 来 将 项 目 站 点 部 蜀 到 远程 服务 器 上 。 
site 生 命 周 期 阶段 与 插件 目标 的 绑 定 关系 如 表 7-2 所 示 。 





表 7-1 _ clean 生命 周期 阶段 与 插件 


生命 周期 阶段 插件 目标 
pre-clean 
clean maven-clean-plugin ; clean 


post-clean 


表 7-2 site 生命 周期 阶段 与 插件 


生命 周期 阶段 插件 目标 
pre-site 
site maven-site-plugin ; site 


post-site 


site-deploy maven-site-plugin ; deploy 


相对 于 clean 和 site 生 命 周期 来 说 ，default 生 命 周期 与 插件 目标 的 绑 
定 关系 就 显得 复杂 一 些 。 这 是 因为 对 于 任何 项 目 来 说 ， 例 如 jar 项 目 和 
war 项 目 ， 它 们 的 项 目 清理 和 站 点 生成 任务 是 一 样 的 ， 不 过 构建 过 程 会 
有 区 别 。 例 如 jar 项 目 需 要 打 成 JAR 包 ， 而 war 项 目 需 要 打 成 WAR 包 。 





由 于 项 目的 打包 类 型 会 影响 构建 的 具体 过 程 ， 因 此 ，default 生 命 周 
期 的 阶段 与 插件 目标 的 绑 定 关系 由 项 目 打 包 类 型 所 决定 ， 打 包 类 型 是 通 
过 POM 中 的 packaging 元 素 定 义 的 ， 有 具体 可 回顾 第 5.2 节 。 最 常见 、 最 重 
要 的 打包 类 型 是 jar， 它 也 是 默认 的 打包 类 型 。 基 于 该 打包 类 型 的 项 目 ， 
其 default 生 命 周期 的 内 置 插 件 绑 定 关系 及 具体 任务 如 表 7-3 所 示 。 


表 7-3 ” default 生命 周 期 的 内 置 插件 绑 定 关系 及 具体 任务 打包 类 型 : 








jar) 
生命 周期 阶段 插件 目标 执行 任务 
process-resources maven-resources-plugin : resources 复制 主 资源 文件 至 主 输出 目录 
compile maven-compiler-plugin :compile 编译 主 代 码 至 主 输出 目录 
process-test-resources maven-resources-plugin :testResources 复制 测试 资源 文件 至 测试 输出 目录 
test-compile maven-compiler-plugin ; testCompile 编译 测试 代码 至 测试 输出 目录 
test maven-surefire-plugin :test 执行 测试 用 例 
package maven-jar-plugin :jar 创建 项 目 jar 包 
install mayen-install-plugin ; install 将 项 目 输出 构件 安装 到 本 地 仓库 
deploy maven-deploy-plugin ; deploy 将 项 目 输出 构件 部 署 到 远程 仓库 





注意 ， 表 7-3 只 列 出 了 拥有 插件 绑 定 关系 的 阶段 ，default 生 命 周期 还 
有 很 多 其 他 阶段 ， 默 认 它 们 没有 绑 定 任何 插件 ， 因 此 也 没有 任何 实际 行 





除了 默认 的 打包 类 型 jar 之 外 ， 第 见 的 打包 类 型 还 有 war、pom、 
maven-plugin、ear 等 。 它 们 的 default 生 命 周期 与 插件 目标 的 绑 定 关系 可 
参阅 Maven 官 方 文 
档 : http://maven.apache.org/guides/introduction/introduction-to-the- 


lifecycle.html#Built-in_Lifecycle_Bindings， 这 里 不 再 袭 述 。 


读者 可 以 从 Maven 的 命令 行 输出 中 看 到 在 项 目 构建 过 程 执行 了 哪些 
插件 目标 ， 例 如 基于 account-email 执 行 mvn clean install 命 令 ， 可 以 看 到 
如 下 输出 ， 见 代码 清单 7-2。 


代码 清单 7-2 ”Maven 输 出 中 包含 了 生命 周期 阶段 与 插件 的 绑 定 关系 


[二 二 省 
[INFO] Building Account Email 1.0.0-SNAPSHOT 


[INFO] -—-- maven-clean-plugin:2.3:clean (default-clean) @ account-email -一 一 
[INFO] Deleting file set: D: \git-juven \maven-book \code \ch-5 \account-email \tar- 
get... 


INFO] --- maven-resources-plugin:2.4,1:resources (default-resources) @ ac- 
count-email --- 
[INFO] Using 'UTF-8'encoding to copy filtered resources. 


[INFO] --- maven-compiler-plugin:2.0.2:compile (default-compile) @ account- 
email 一 -一 

[INFO] Compiling 3 source files to D:\git-juven \maven-book \code \... 

[INFO] --- maven-resources-plugin:2.4.1:testResources (default-testResources) 
@ account-email 一 一 = 


[INFO] Using 'UTF-8'encoding to copy filtered resources. 
[INFO] -—-- maven-compiler-plugin:2.0.2:testCompile (default-testCompile) @ ac- 
count-email --- 


[INFO] Compiling 1 source file to... 


[INFO] --- maven-surefire-plugin:2.4.3:test (default-test) @ account-email -- 
[INFO] Surefire report directory: D:\git-—juven \maven-book \ code \... 


[INFO] --- maven-jar-plugin:2.2:jar (default-jar) @ account-email --- 
[INFO] Building jar: D:\gqit-juven \maven-book \ code \.... 


[INFO] --- maven-install-plugin:2.3:install (default-install) @ account-email 


[INFO] Installing D: \git-juven \maven-book \ code \... 

[INFO] ------—---—------------------------------------------------ 
[INFO] BUILD SUCCESS 

(INFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 一 二 一 一 一 一 


从 输出 中 可 以 看 到 ， 执 行 的 插件 目标 依次 为 maven-clean-plugin: 
clean、maven-resources-plugin: resources、maven-compiler-plugin: 
compile, maven-resources-plugin: testResources、maven-compiler- 
plugin: testCompile, maven-surefire-plugin: test. maven-jar-plugin: jar 
Allmaven-install-plugin: install。 我 们 知道 ，mvn clean install 命 令 实际 调 


用 了 clean 生 命 周期 的 pre-clean、clean 阶 段 ， 以 及 default 牛 命 周 期 的 从 


validate 至 instal 所 有 阶段 。 在 此 基础 上 上， 通过 对 照 表 7-1 和 表 7-3， 就 能 
从 理论 上 得 到 将 会 执行 的 插件 目标 任务 ， 而 实际 的 输出 完全 验证 了 这 一 
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除了 内 置 绑 定 以 外 ， 用 户 还 能 够 自己 选择 将 东 个 插件 目标 绑 定 到 生 
命 周 期 的 东 个 阶段 上 ， 这 种 目 定 义 绑 定 方式 能 让 Maven 项 目 在 构建 过 程 
中 执行 更 多 更 富 特 色 的 任务 。 


一 个 常见 的 例子 是 创建 项 目的 源码 jar 包 ， 内 置 的 插件 绑 定 关系 中 并 
没有 涉及 这 一 任务 ， 因 此 需要 用 户 自行 配置 。maven-source-plugin 可 以 
帮助 我 们 完成 该 任务 ， 它 的 jar-no-fork 目 标 能 够 将 项 目的 主 代码 打包 成 
jar 文 件 ， 可 以 将 其 绑 定 到 default 生 命 周期 的 verify 阶 段 上 ， 在 执行 完 集 
成 测试 后 和 安装 构件 之 前 创建 源码 jar 包 。 有 具体 配置 见 代 码 清单 7-3。 








代码 清单 7-3 ” 目 定 义 绑 定 插件 目标 


< groupId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-source-plugin < /artifactId> 
<version >2.1.1< /version > 


ions > 





execution > 
<id>attach-sources < /id> 


<phase >verify < /phase > 


<goal > jar-no-fork < /goal > 


< /goal 
< /executio 
>xecut i 


在 POM 的 build 元 素 下 的 plugins 子 元 素 中 声明 插件 的 使 用 ， 该 例 中 用 
到 的 是 maven-source-plugin， 其 groupId 为 org.apache.maven.plugins， 这 也 
是 Maven 官 方 插件 的 groupId， 紧 接着 artifactId 为 maven-source-plugin， 
version 为 2.1.1。 对 于 目 定 义 绑 定 的 插件 ， 用 户 总 是 应 该 声明 一 个 非 快照 
版 本 ， 这 样 可 以 避免 由 于 插件 版 本 变化 造成 的 构建 不 稳定 性 。 





上 述 配 置 中 ， 除 了 基本 的 插件 坐标 声明 外 ， 还 有 插件 执行 配置 ， 
executions 下 每 个 execution 子 元 素 可 以 用 来 配置 执行 一 个 任务 。 该 例 中 配 
置 了 一 个 id 为 attach-sources 的 任务 ， 通 过 phrase 配 置 ， 将 其 绑 定 到 verify 
生命 周期 阶段 上 ， 再 通过 goals 配 置 指 定 要 执行 的 插件 目标 。 至 此 ， 自 定 
义 插 件 绑 定 完成 。 运 行 mvn verify 就 能 看 到 如 下 输出 : 


[INFO] 一 一 一 maven-source-p iach .1.1:jar-no-fork (attach-sources) @ nein 一 一 
[INFO] Building jar: D: \code \« cae! \target \my-proj]-0.0.1-SNAPSHOT-sou s. jar 


我 们 可 以 看 到 ， 当 执行 verify 生 命 周 期 阶段 的 时 候 ，maven-source- 
plugin: jar-no-fork 会 得 以 执行 ， 它 会 创建 一 个 以 -sources.jar 结 尾 的 源码 
文件 包 。 


有 了 时候 ， 即 使 不 通过 phase 元 素 配 置 生 命 周 期 阶段 ， 插 件 目标 也 能 
够 绑 定 到 生命 周期 中 去 。 例 如 ， 可 以 党 试 删 除 上 述 配置 中 的 phase 一 
行 ， 再 次 执行 mvn verify， 仍 然 可 以 看 到 maven-source-plugin: jar-no- 
fork 得 以 执行 。 出 现 这 种 现象 的 原因 是 : 有 很 多 插件 的 目标 在 编写 时 已 
经 定义 了 默认 绑 定 阶段 。 可 以 使 用 maven-help-plugin 碍 看 插件 详细 信 








， 了 解 插件 目标 的 默认 绑 定 阶段 。 运 行 命令 如 下 : 


$ mvn help: describe-Dplugin = ord.apache.maven,plugins:maven- source-plugin: 
2rd .1-Ddetail 


该 命令 输出 对 应 插件 的 详细 信息 。 在 输出 信息 中 ， 能 够 看 到 关于 目 
标 jar-no-fork 的 如 下 信息 : 


source:jar-no-fork 
Description: This goal bundles all t sources into a jar archive. This 
goal functions the same as the jar go Si but does not fork the build and is 
suitable for attaching to the build lifecycle. 
Deprecated. No reason given 
Implementation: org. apache, maven. plugin. source. SourceJarNoForkMojo 
Language: java 


Bound to phase: package 


Avallable parameters: 





该 输出 包含 了 一 段 关 于 jar-no-fork 目 标的 描述 ， 这 里 关心 的 是 Bound 
to phase 这 一 项 ， 它 表示 该 目标 默认 绑 定 的 生命 周期 阶段 〈 这 里 是 
package) 。 也 就 是 说 ， 当 用 户 配 置 使 用 maven-source-plugin 的 jar-no-fork 
目标 的 时 候 ， 如 果 不 指 定 phase 参 数 ， 该 目标 就 会 被 绑 定 到 package 阶 
段 。 








我 们 知道 ， 当 插件 目标 被 绑 定 到 不 同 的 生命 周期 阶段 的 时 候 ， 其 执 
行 顺序 会 由 生命 周期 阶段 的 先后 顺序 决定 。 如 末 多 个 目标 被 绑 定 到 同一 
个 阶段 ， 它 们 的 执行 顺序 会 是 上 怎样? 答案 很 简单 ， 当 多 个 插件 目标 绑 定 
到 同一 个 阶段 的 时 候 ， 这 些 插 件 声 明 的 先后 顺序 决定 了 目标 的 执行 顺 
序 。 


7.5 插件 配置 


完成 了 插件 和 生命 周期 的 绑 定之 后 ， 用 户 还 可 以 配置 插件 目标 的 参 
数 ， 进 一 步调 整 插件 目标 所 执行 的 任务 ， 以 满足 项 目的 需求 。 几 乎 所 有 
Maven 插 件 的 目标 都 有 一 些 可 配置 的 参数 ， 用 户 可 以 通过 命令 行 和 POM 
配置 等 方式 来 配置 这 些 参数 。 





7.5.1 命令 行 插件 配置 


在 日 常 的 Maven 使 用 中 ， 我 们 会 经 常 从 命令 行 输 入 并 执行 Maven 命 
令 。 在 这 种 情况 下 ， 如 果 能 够 方便 地 更 改 某 些 插件 的 行为 ， 无 疑 会 十 分 
方便 。 很 多 插件 目标 的 参数 都 支持 从 命令 行 配置 ， 用 户 可 以 在 Maven 命 
令 中 使 用 -D 参 数 ， 并 伴随 一 个 参数 键 = 参数 值 的 形式 ， 来 配置 插件 目标 
的 参数 。 


例如 ，maven-surefire-plugin 提 供 了 一 个 maven.test.skip 参 数 ， 当 其 值 
为 true 的 时 候 ， 就 会 跳 过 执行 测试 。 于 是 ， 在 运行 命令 的 时 候 ， 加 上 如 
下 -D 参 数 就 能 跳 过 测试 : 


$s mvn install-Dmaven.test.skip =true 


参数 -D 是 Java 目 带 的 ， 其 功能 是 通过 命令 行 设 置 一 个 Java 系 统 属 
性 ，Maven 简 单 地 重用 了 该 参数 ， 在 准备 插件 的 时 候 检查 系统 属性 ， 便 
实现 了 插件 参数 的 配置 。 


7.5.2 POM 中 插件 全 局 配置 


并 不 是 所 有 的 插件 参数 都 适合 从 命令 行 配置 ， 有 些 参 数 的 值 从 项 目 
创建 到 项 目 发 布 都 不 会 改变 ， 或 者 说 很 少 改变 ， 对 于 这 种 情况 ， 在 POM 
文件 中 一 次 性 配置 就 显然 比重 复 在 命令 行 输入 要 方便 。 








用 户 可 以 在 声明 插件 的 时 候 ， 对 此 插件 进行 一 个 全 局 的 配置 。 也 就 
是 说 ， 所 有 该 基于 该 插件 目标 的 任务 ， 都 会 使 用 这 些 配 置 。 例 如 ， 我 们 
通常 会 需要 配置 maven-compiler-plugin 告 诉 它 编译 Java 1.5 版 本 的 源 文 
件 ， 生 成 与 JVM 1.5 兼 容 的 字 节 码 文件 ， 见 代码 清单 7-4。 





代码 清单 7-4 在 POM 中 对 插件 进行 全 局 配置 


< GroupIG >org. aba che. m plugins < /groupId 
<artifactIid >maven-compi emp ugin < /artifac tid> 
<version >2.1</version> 
conf ELIDA on > 
irce>1. /source > 

<target >1. /target > 
< /configurat isn > 
E im i wer 

Adio 


< /build > 


这 样 ， 不 管 绑 定 到 compile 阶 段 的 maven-compiler-plugin: compile 任 
务 ， 还 是 绑 定 到 test-compiler 阶 段 的 maven-compiler-plugin: testCompiler 
任务 ， 就 都 能 够 使 用 该 配置 ， 基 于 Java 1.5 版 本 进行 编译 。 


7.5.3 POM 中 插件 任务 配置 


除了 为 插件 配置 全 局 的 参数 ， 用 户 还 可 以 为 某 个 插件 任务 配置 特定 
的 参数 。 以 maven-antrun-plugin 为 例 ， 它 有 一 个 目标 run， 可 以 用 来 在 
Maven 中 调用 Ant 任 务 。 用 户 将 maven-antrun-plugin: run 绑 定 到 多 个 生命 
周期 阶段 上 ， 再 加 以 不 同 的 配置 ， 就 可 以 让 Maven 在 不 同 的 生命 阶段 执 
行 不 同 的 任务 ， 见 代码 清单 7-5。 


代码 清单 7-5 ”在 POM 中 对 插件 进行 任务 配置 


<build> 
<plugins > 
<plugin > 
<grouplid >org. apache. maven. plugins < /groupId > 
<artifactId >maven-antrun-plugin < /artifactId> 
<version >1.3 < /version > 
< executions > 
<execution > 
<id>ant-validate < ”ia > 
<phase >validate < / phase > 
<coals > 
<goal >run< /goal > 
< /goals > 
<configuration > 
<tasks > 
<echo >I'm bound to validate phase. < /echo > 
</tasks > 
< /configuration > 
< f/execution > 
<execution > 
<id>ant-verify </id> 
<phase >verify < /phase > 
<goals > 
<goal >run < /goal > 
< /goals > 
<configuration > 


<tasks > 





在 上 述 代 码 片 段 中 ， 首 先 ，maven-antrun-plugin: run 与 validate 阶 段 
绑 定 ， 从 而 构成 一 个 id 为 ant-validate 的 任务 。 插 件 全 局 配置 中 的 
configuration 元 素 位 于 plugin 元 素 下 面 ， 而 这 里 的 configuration 元 素 则 位 
于 execution 元 素 下 ， 表 示 这 是 特定 任务 的 配置 ， 而 非 插 件 整体 的 配置 。 
这 个 ant-validate 任 务 配置 了 一 个 echo Ant 任 务 ， 向 命令 行 输出 一 段 文 
字 ， 表 示 该 任务 是 绑 定 到 validate 阶 段 的。 第 二 个 任务 的 id 为 ant-verify， 
它 绑 定 到 了 verify 阶 段 ， 同 样 它 也 输出 一 段 文 字 到 命令 行 ， 告 诉 该 任务 
绑 定 到 了 verify 阶 段 。 








7.6 获取 插件 信息 


仅仅 理解 如 何 配 置 使 用 插件 是 不 够 的 。 当 过 到 一 个 构建 任务 的 时 
候 ， 用 户 还 需要 知道 去 哪里 寻找 合适 的 插件 ， 以 帮助 完成 任务 。 找 到 正 
确 的 插件 之 后 ， 还 要 详细 了 解 该 插件 的 配置 点 。 由 于 Maven 的 插件 非常 
多 ， 而 且 这 其 中 的 大 部 分 没有 完善 的 文档 ， 因 此 ， 使 用 正确 的 插件 并 进 
行 正确 的 配置 ， 其 实 并 不 是 一 件 容易 的 事 。 


7.6.1 在线 插件 信息 


基本 上 上 所 有 主要 的 Maven 插 件 都 来 自 Apache 和 Codehaus。 由 于 
Maven 本 身 是 属于 Apache 软 件 基 金 会 的 ， 因 此 它 有 很 多 官方 的 插件 ， 每 
天 都 有 成 二 上 万 的 Maven 用 户 在 使 用 这 些 插 件 ， 它 们 具有 非常 好 的 稳定 
性 。 详细 的 列表 可 以 在 这 个 地 址 得 
到 : http://maven.apache.org/plugins/index.html， 单 击 某 个 插件 的 链接 便 
可 以 得 到 进一步 的 信息 。 所 有 官方 插件 能 在 这 里 下 


载 : http://repol.maven.org/maven2/org/apache/maven/plugins/。 














除了 Apache 上 的 官方 插件 之 外 ， 托 管 于 Codehaus 上 的 Mojo 项 目 也 提 
供 了 大 量 了 Maven 插 件 ， 详 细 的 列表 可 以 访 
Ùj: http:/mojo.codehaus.org/plugins.html。 需 要 注意 的 是 ， 这 些 插件 的 
文档 和 可 靠 性 相对 较 差 ， 在 使 用 时 ， 如 果 遇 到 问题 ， 往 往 只 能 自己 去 看 
源 代码 。 所 有 Codehaus 的 Maven 插 件 能 在 这 里 下 


载 : http://repository.codehaus.org/org/codehaus/mojo/。 


由 于 上 述 两 个 站 点 提供 的 插件 非常 多 ， 而 实际 使 用 中 第 用 的 插件 远 
不 会 是 这 个 数量 ， 因 此 附录 C 归 纳 了 一 些 比较 常用 的 插件 。 





虽然 并 非 所 有 插件 都 提供 了 完善 的 文档 ， 但 一 些 核心 插件 的 文档 还 
是 非常 丰富 的 。 以 maven-surefire-plugin 为 例 ， 访 问 


http://maven.apache.org/plugins/maven-surefire-plugin/ 可 以 看 到 该 插件 的 
简要 介绍 、 包 含 的 目标 、 使 用 介绍 、FAQ 以 及 很 多 实例 ， 如 图 7-3 所 


Overview Maven Surefire Plugin 


Introduction 


The Surefire Plugin is used during the test phase of the build lifecycle to execute the unit 


es Plain text files (~.txt) 
Examples * XML files (*.xml) 


cette be By default, these files are generated at ${basedir}/terget/surefire-reports. 

Skipping Tests 

Inclusions and Exclusions 2 

of Tests For an HTML format of the report, please see the Maven Surefire Report Plugin Œ. 
Running a Single Test 

Class Loading Issues 

Debugging Tests 

System Properties Goals Overview 

Additional Classpath 

Elements 


The Surefire Plugin has only 1 goal: 


Project Documentation P T 4 
A s surefire:test runs the unit tests of an application. 

¥ Project Information 
About 
Continuous 
Integration 
Dependencies 
Dependency 
Convergence 
Dependency 


-Usage 


General instructions on how to use the Surefire Plugin can be found on the usage page, 
examples, tips or errata to the plugin's wiki page œ. 





图 7-3 ”maven-surefire-plugin 的 文档 页 面 


一 般 来 说 ， 通 过 阅读 插件 文档 中 的 使 用 介绍 和 实例 ， 就 应 该 能 够 在 
目 己 的 项 目 中 很 好 地 使 用 该 插件 。 但 当 我 们 想 了 解 非 常 细节 的 目标 参数 
时 ， 就 需要 进一步 访问 该 插件 每 个 目标 的 文档 。 以 maven-surefire-plugin 
为 例 〈 见 第 7.5.1 市 ) ， 可 以 通过 在 命令 行 传 入 maven.test.skip 参 数 来 跳 
过 测试 执行 ， 而 执行 测试 的 插件 目标 是 surefire: test， 访 问 其 文 





档 : http://maven.apache.org/plugins/maven-surefire-plugin/test- 


mojo.html， 可 以 找到 目标 参数 skip， 如 图 7-4 所 示 。 


tine 
dbad ot © 


Set this to 'true' to bypass unit tests entirely. Its use is NOT RECOMMENDED, especially if 
you enable it using the "maven.test.skip" property, because maven.test.skip disables both 
running the tests and compiling the tests. Consider using the skipTests parameter instead. 


e Type: boolean 
* Required: Ho 
+ Expression: ${maven. test. skip} 





图 7-4 maven-surefire-plugin: test 的 Skip 参数 





文档 详细 解释 了 该 参数 的 作用 、 类 型 等 信息 。 基 于 该 信息 ， 用 户 可 
以 在 POM 中 配置 maven-surefire-plugin 的 Skip 参数 为 true 来 跳 过 测试 。 这 
个 时 候 读 者 可 能 会 不 理解 了 ， 之 前 在 命令 行 传 入 的 参数 不 是 
maven.test.skip 吗 ? 的 确 如 此 ， 虽 然 对 于 该 插件 目标 的 作用 是 一 样 的 ， 
但 从 命令 行 传 入 的 参数 确实 不 同 于 该 插件 目标 的 参数 名 称 。 命 令 行 参数 
是 由 该 插件 参数 的 表达 式 (Expression) 决定 的 。 从 图 7-4 中 能 够 看 到 ， 
surefire: test skip 参 数 的 表达 式 为 $ {maven.test.skip}， 它 表示 可 以 在 命 
令 行 以 -Dmaven.test.skip=true 的 方式 配置 该 目标 。 并 不 是 所 有 插件 目标 
参数 都 有 表达 式 ， 也 就 是 说 ， 一 些 插件 目标 参数 只 能 在 POM 中 配置 。 











7.6.2 ”使 用 maven-help-plugin 摘 述 插件 


除了 访问 在 线 的 插件 文档 之 外 ， 还 可 以 借助 maven-help-plugin 来 获 
取 插 件 的 详细 信息 。 可 以 运行 如 下 命令 来 获取 maven-compiler-plugin 2.1 
版 本 的 信息 : 





$ mn help: describeDplugin = org.apache.maven.plugins: maven-compiler- 


plugin:2.1 


这 里 执行 的 是 maven-help-plugin 的 describe 目 标 ， 在 参数 plugin 中 输 
入 需要 描述 插件 的 groupId、artifactId 和 version。Maven 在 命令 行 输出 
maven-compiler-plugin 的 简要 人 信息， 包括 该 插件 的 坐标 、 目 标 前 级 和 目 


标 等 ， 见 代码 清单 7-6。 


代码 清单 7-6 ”使 用 maven-help-plugin 获 取 插 件 信 息 


Name: Maven Compiler Plugin 

Description: The Compiler Plugin is used to compile the sources of your 
project. 

Group Id: org. apache. maven. plugins 

Artifact Id: maven-compiler-plugin 

Version: 2.1 


Goal Prefix: compiler 
This plugin has 3 goals: 


compiler:compile 


Description: Compiles application sources 


compiler :help 
Description: Display help information on maven-compiler-plugin. 
Call 
mvn compiler :help-Ddetail =true-Dgoal = <goal-name > 
to display parameter details. 


compiler :testCompile 
Description: Compiles application test sources. 


T 


For more information, run'mvn help:describe [..]-Ddetail' 





TF Ab ip AEE A hs, AN Se RE, X EELS: FEE H eR 
(Goal Prefix) ， 其 作用 是 方便 在 命令 行 直 接 运 行 插件 。 在 第 7.8 节 会 做 


进一步 解释 。maven-compiler-plugin 的 目标 前 级 是 compiler。 
在 描述 插件 的 时 候 ， 还 可 以 省 去 版 本 信息 ， 让 Maven 自 动 获取 最 新 
版 本 来 进行 表述 。 例 如 : 


$ mvn help:describe-Dplugin =org.apache.maven.plugins:maven-compiler-plugin 


进一步 人 简化， 可 以 使 用 插件 目标 前 级 蔡 换 坐标 。 例 如 : 
$ mvn help:describe-Dplugin =compiler 
如 采 想 仅仅 描述 某 个 插件 目标 的 信息 ， 可 以 加 上 goal 参 数 : 


$ mvn help:describe-Dplugin = compiler-Dgoal =compile 


如 果 想 让 maven-help-plugin 输 出 更 详细 的 信息 ， 可 以 加 上 detail 参 
数 : 


$ mvn help:describe-Dplugin = compiler-Ddetail 


读者 可 以 在 实际 环境 中 使 用 help: describe 描 述 一 些 常 用 插件 的 信 
恩 ， 以 得 到 更 加 直观 的 感受 。 


7.7 ”从 命令 行 调用 插件 


如 果 在 命令 行 运行 mvn-h 来 显示 mvn 命 令 帮 助 ， 就 可 以 看 到 如 下 的 


该 信息 告诉 了 我 们 mvn 命 令 的 基本 用 法 ，options 表 示 可 用 的 选项 ， 
mvn 命 令 有 20 多 个 选项 ， 这 里 暂 不 详 述 ， 读 者 可 以 根据 说 明 来 了 解 每 个 
选项 的 作用 。 除 了 选项 之 外 ，mvn 命 令 后 面 可 以 添加 一 个 或 者 多 个 goal 
和 phase， 它 们 分 别 是 指 插件 目标 和 生命 周期 阶段 。 第 7.2.5 节 已 经 详细 
介绍 了 如 何 通 过 该 参数 控制 Maven 的 生命 周期 。 现 在 我 们 关心 的 是 另外 


一 个 参数 : goal。 


我 们 知道 ， 可 以 通过 mvn 命 令 激活 生命 周期 阶段 ， 从 而 执行 那些 绑 
定 在 生命 周期 阶段 上 的 插件 目标 。 但 Maven 还 支持 直接 从 命令 行 调用 插 
件 目标 。Maven 文 持 这 种 方式 是 因为 有 些 任 务 不 适合 绑 定 在 生命 周期 
上 ， 例 如 maven-help-plugin: describe， 我 们 不 需要 在 构建 项 目的 时 候 去 
描述 插件 信息 ， 又 如 maven-dependency-plugin: tree， 我 们 也 不 需要 在 构 
建 项 目的 时 候 去 显示 依赖 树 。 因 此 这 些 插件 目标 应 该 通过 如 下 方式 使 
用 : 











不 过 ， 这 里 还 有 一 个 疑问 ，describe 是 maven-help-plugin 的 目标 没 
错 ， 但 冒 扎 前 面 的 help 是 什么 呢 ? 它 既 不 是 groupId， 也 不 是 artifactId， 
Maven 是 如 何 根 据 该 信息 找到 对 应 版 本 插件 的 呢 ? 同 理 ， 为 什么 不 是 


maven-dependency-plugin: tree， 而 是 dependency: tree? 


解答 该 疑问 之 前 ， 可 以 先 尝试 一 下 如 下 的 命令 : 


$ mvn org.apache.maven.plugins :maven-help-plugin :2,1:describe-Dplugin =compilex 


$ mvn org. apache. maven. plugins :maven-dependency-plugin:2.1:tree 


这 两 条 命令 就 比较 容易 理解 了 ， 插 件 的 groupId、artifactId、version 
以 及 goal 都 得 以 清晰 描述 。 它 们 的 效果 与 之 前 的 两 条 命令 基本 是 一 样 
的 ， 但 显然 前 面 的 命令 更 简洁 ， 更 容易 记忆 和 使 用 。 为 了 达到 该 目的 ， 
Maven 引 入 了 目标 前 绥 的 概念 ，help 是 maven-help-plugin 的 目标 前 绥 ， 
dependency 是 maven-dependency-plugin 的 前 级 ， 有 了 插件 前 级 ，Maven 
就 能 找到 对 应 的 artifactId。 不 过 ， 除 了 artifactd，Maven 还 需要 得 到 
groupId 和 version 才 能 精确 定位 到 某 个 插件 。 下 一 节 将 详细 解释 这 个 过 


程 。 


7.8 ”插件 解析 机 制 


为 了 方便 用 户 使 用 和 配置 插件 ，Maven 不 需要 用 户 提 供 完整 的 插件 
坐标 信息 ， 就 可 以 解析 得 到 正确 的 插件 ，Maven 的 这 一 特性 是 一 把 双 刃 
剑 ， 虽 然 它 简化 了 插件 的 使 用 和 配置 ， 可 一 旦 插件 的 行为 出 现 异常 ， 用 
户 就 很 难 快速 定位 到 出 问题 的 插件 构件 。 例 如 mvn help: system 这 样 一 
条 命令 ， 它 到 底 执行 了 什么 插件 ? 该 插件 的 groupId、artifacttd 和 version 
分 别 是 什么 ? 这 个 构件 是 从 哪里 来 的 ? 本 节 就 详细 介绍 Maven 的 运行 机 
制 ， 以 让 读者 不 仅 知 其 然 ， 更 知 其 所 以 然 。 





7.8.1 插件 仓库 





与 依赖 构件 一 样 ， 插 件 构件 同样 基于 坐标 存储 在 Maven 仓 库 中 。 在 
需要 的 时 候 ，Maven 会 从 本 地 仓库 寻找 插件 ， 如 果 不 存在 ， 则 从 远程 仓 
库 查找 。 找 到 插件 之 后 ， 再 下 载 到 本 地 仓库 使 用 。 





值得 一 提 的 是 ，Maven 会 区 别 对 符 依 赖 的 远程 仓库 与 插件 的 远程 仓 
库 ， 第 6.4 贡 介绍 了 如 何 配置 远程 仓库 ， 但 那 种 配置 只 对 一 般 依 赖 有 效 
果 。 当 Maven 需 要 的 依赖 在 本 地 仓库 不 存在 时 ， 它 会 去 所 配置 的 远程 仓 
库 碍 找 ， 可 是 当 Maven 需 要 的 插件 在 本 地 仓库 不 存在 时 ， 它 吏 不 会 去 这 
些 远程 仓库 查找 。 





不 同 于 repositories 及 其 repository 子 元 素 ， 插 件 的 远程 仓库 使 用 
pluginRepositories 和 pluginRepository 配 置 。 例 如 ，Maven 内 置 了 如 下 的 
插件 远程 仓库 配置 ， 见 代码 清单 7-7。 


代码 清单 7-7 Maven 内 置 的 插件 仓库 配置 





ginReposit 1 
pluginR -Ory > 
d>centré </id> 
ame >Maven Plugin Repository < /name > 


rli>http://repol.maven.org/maven2 < /url > 





除了 pluginRepositories 和 pluginRepository 标 签 不 同 之 外 ， 其 余 所 有 
子 元 素 表达 的 含义 与 第 6.4 节 所 介绍 的 依赖 远程 仓库 配置 完全 一 样 。 我 
们 甚至 看 到 ， 这 个 默认 插件 仓库 的 地 址 就 是 中 央 仓 库 ， 它 关闭 了 对 
SNAPSHOT 的 支持 ， 以 防止 引入 SNAPSHOT 版 本 的 插件 而 导致 不 稳定 
的 构建 。 





一 般 来 说 ， 中 央 仓库 所 包含 的 插件 完全 能 够 满足 我 们 的 需要 ， 因 此 
也 不 需要 配置 其 他 的 插件 仓库 。 只 有 在 很 少 的 情况 下 ， 项 目 使 用 的 插件 
无 法 在 中 央 仓 库 找到 ， 或 者 自己 编写 了 插件 ， 这 个 时 候 可 以 参考 上 述 的 
配置 ， 在 POM 或 者 settings.xml 中 加 入 其 他 的 插件 仓库 配置 。 


7.8.2 ”插件 的 默认 groupId 


在 POM 中 配置 插件 的 时 候 ， 如 果 该 插件 是 Maven 的 官方 插件 〈( 即 如 
果 其 groupId 为 org.apache.maven.plugins) ， 就 可 以 省 略 groupId 配 置 ， 见 
代码 清单 7-8。 


代码 清单 7-8 配置 官方 插件 和 省 略 groupId 


version >2.1 </version> 
< configuration > 
<source >1.5 < /source > 


上 述 配 置 中 省 略 了 maven-compiler-plugin 的 groupId，Maven 在 解析 
该 插件 的 时 候 ， 会 自动 用 默认 groupId org.apache.maven.plugins 补 齐 。 


笔者 不 推荐 使 用 Maven 的 这 一 机 制 ， 虽 然 这 么 做 可 以 省 略 一 些 配 
置 ， 但 这 样 的 配置 会 让 团队 中 不 熟悉 Maven 的 成 员 感 到 费解 ， 况 且 能 省 
略 的 配置 也 就 仅仅 一 行 而 已 。 





7.8.3 ”解析 插件 版 本 


同样 是 为 了 简化 插件 的 配置 和 使 用 ， 在 用 户 没 有 提供 插件 版 本 的 情 
况 下 ，Maven 会 自动 解析 插件 版 本 。 


首先 ，Maven 在 超级 POM 中 为 所 有 核心 插件 设 定 了 版 本 ， 超 级 POM 
是 所 有 Maven 项 目的 父 POM， 上 所 有 项 目 都 继承 这 个 超级 POM 的 配置 ， 
此 ， 即 使 用 户 不 加 任何 配置 ，Maven 使 用 核心 插件 的 时 候 ， 它 们 的 版 本 
就 已 经 确定 了 。 这 些 插 件 包括 maven-clean-plugin、maven-compiler- 


plugin、maven-surefire-plugin 等 。 


如 果 用 户 使 用 某 个 插件 时 没有 设 定 版 本 ， 而 这 个 插件 义 不 属 于 核心 
插件 的 范畴 ，Maven 了 就 会 去 检查 所 有 仓库 中 可 用 的 版 本 ， 然 后 做 出 选 
择 。 读 者 可 以 回顾 一 下 第 6.6 节 中 介绍 的 仓库 元 数据 
groupId/artifactId/maven-metadata.xml。 以 maven-compiler-plugin 为 例 ， 
它 在 中 央 仓 库 的 仓库 元 数据 


为 http:/repo1.maven.org/maven2/org/apache/maven/plugins/maven- 





compiler-plugin/maven-metadata.xml， 其 内 容 见 代码 清单 7-9。 


代码 清单 7-9 maven-compiler-plugin 的 groupId/artifactId 仓 库 元 数据 


metadat 
yroupid s he.maven. plugir J Id 
| I -compiler-p] 1 Í t 
1 lates 
/relea 
O0-beta- fersior 
on 





<y sions > 
< lastUpdated >20100102092331 < /lastUpdated > 
< /versioni > 


Mavenil JAEEEM A ee Fe, RARE FEE 
据 归 并 后 ， 就 能 计算 出 latest 和 release 的 值 。latest 表 示 所 有 仓库 中 该 构件 
的 最 新 版 本 ， 而 release 表 示 最 新 的 非 快照 版 本 。 在 Maven 2 中 ， 插 件 的 
版 本 会 被 解析 至 latest。 也 就 是 说 ， 当 用 户 使 用 茶 个 非 核 心 插 件 且 没 有 声 
明 版 本 的 时 候 ，Maven 会 将 版 本 解析 为 所 有 可 用 仓库 中 的 最 新 版 本 ， 而 
这 个 版 本 也 可 能 是 快照 版 。 











当 插 件 的 版 本 为 快照 版 本 时 ， 就 会 出 现 潜 在 的 问题 。Maven 会 基于 
更 新 策略 ， 检 查 并 使 用 快照 的 更 新 。 某 个 插件 可 能 昨天 还 用 得 好 好 的 ， 
今天 就 出 错 了 ， 其 原因 就 是 这 个 快照 版 本 的 插件 发 生 了 变化 。 为 了 防止 
这 类 问题 ，Maven 3 调整 了 解析 机 制 ， 当 插件 没有 声明 版 本 的 时 候 ， 不 
再 解析 至 latest， 而 是 使 用 release。 这 样 就 可 以 避免 由 于 快照 频繁 更 新 而 
导致 的 插件 行为 不 稳定 。 


依赖 Maven 解 析 插 件 版 本 其 实 古 不 推荐 的 做 法 ， 即 使 Maven 3 将 版 


本 解析 a 到 最 新 的 非 快 照 版 ， 也 还 是 会 有 潜在 的 不 稳定 性 。 例 如 ， 可 能 
个 插件 肥 布 了 一 个 新 的 版 本 ， 而 这 个 版 本 的 行为 与 之 前 的 版 本 及 生 了 变 
化 ， 这 种 变化 就 可 能 导致 项 目 构建 失败 。 因 此 ， 使 用 插件 的 时 候 ， 应 该 
一 直 显 式 地 设 定 版 本 ， 这 也 解释 了 Maven 为 什么 要 在 超级 POM 中 为 核心 
插件 设 定 版 本 。 


7.8.4 ”解析 插件 前 级 


前 面 讲 到 mvn 命 令 行 支持 使 用 插件 前 级 来 简化 插件 的 调用 ， 现 在 解 
释 Maven 如 何 根据 插件 前 级 解析 得 到 插件 的 坐标 。 





插件 前 级 与 groupId: artifactId 是 一 一 对 应 的 ， 这 种 匹配 关系 存储 在 
仓库 元 数据 中 。 与 之 前 提 到 的 groupId/artifactId/maven-metadata.xml 不 
同 ， 这 里 的 仓库 元 数据 为 groupId/maven-metadata.xml， 那 么 这 里 的 
groupId 是 什么 呢 ? 第 7.6.1 节 提 到 主要 的 插件 都 位 于 


http:/repo1.maven.org/maven2/org/apache/maven/plugins/ 和 





http://repository.codehaus.org/org/codehaus/mojo/， 相 应 地 ，Maven 在 解析 
插件 仓库 元 数据 的 时 候 ， 会 默认 使 用 org.apache.maven.plugins 和 
org.codehaus.mojo 两 个 groupId。 也 可 以 通过 配置 settings.xml 让 Maven 检 
查 其 他 groupId 上 的 插件 仓库 元 数据 : 


<settings > 
<pluginGroups > 
<pluginGroup >com. your. plugins < /pluginGroup > 
< /pluginGroups > 
< / settings > 


基于 该 配置 ，Maven 就 不 仅仅 会 检查 
org/apache/maven/plugins/maven-metadata.xml 和 org/codehaus/mojo/maven- 


metadata.xml， 还 会 检查 com/youvplugins/maven-metadata.xml。 


下 面 看 一 下 插件 仓库 元 数据 的 内 容 ， 见 代码 清单 7-10。 


代码 清单 7-10 ”插件 仓库 元 数据 


<metadata > 


<plugins > 


<name >Maven Clean Plugin< /name > 
<prefix >clean < /prefix > 
<artifactid >maven-clean-plugin < /artifactid> 


<name >Maven Compiler Plugin < /name > 
«prefix >compiler < /prefix > 


<artifactid >maven-compiler-plugin < /artifactId> 


<name >Maven Dependency Plugin < /name > 
< prefix >dependency < /prefix > 


<artifactIid >maven-dependency-plugin < /artifactId> 
</plugin > 
< /plugins > 
< /metadata > 


上 述 内 容 是 从 中 央 仓 库 的 org.apache.maven.plugins groupId 下 插件 仓 
库 元 数据 中 截取 的 一 些 片 段 ， 从 这 上 段 数 据 中 就 能 看 到 maven-clean-plugin 
的 前 绥 为 clean，maven-compiler-plugin 的 前 缀 为 compiler，maven- 


dependency-plugin 的 前 级 为 dependency。 


当 Maven 解 析 到 dependency: tree 这 样 的 命令 后 ， 它 首先 基于 默认 的 
groupId 归 并 所 有 插件 仓库 的 元 数据 org/apache/maven/plugins/maven- 
metadata.xml; 其 次 检查 归并 后 的 元 数据 ， 找 到 对 应 的 artifactId 为 maven- 
dependency-plugin; 然后 结合 当前 元 数据 的 groupId 
org.apache.maven.plugins; 最 后 使 用 第 7.8.3 市 揪 述 的 方法 解析 得 到 





version， 这 时 就 得 到 了 完整 的 插件 坐标 。 如 果 
org/apache/maven/plugins/maven-metadata.xml 没 有 记录 该 插件 前 级 ， 则 
接着 检查 其 他 groupId 下 的 元 数据 ， 如 org/codehaus/mojo/maven- 
metadata.xml， 以 及 用 户 自 定义 的 插件 组 。 如 果 所 有 元 数据 中 都 不 包含 


TARE, 则 报错 。 


79 小 党 


本 章 介 绍 了 Maven 的 生命 周期 和 插件 这 两 个 重要 的 概念 。 不 仅 解 释 
了 生命 周期 背后 的 理念 ， 还 详细 阐述 了 clean、default、site 三 套 生 命 周 
期 各 目的 内 容 。 此 外 ， 本 章 还 重点 介绍 了 Maven 插 件 如 何 与 生命 周期 绑 
定 ， 以 及 如 何 配置 插件 行为 ， 如 何 获取 插件 信息 。 该 者 还 能 从 命令 行 的 
视角 来 理解 生命 周期 和 插件 。 本 章 最 后 结合 仓库 元 数据 剖析 了 Maven 内 
部 的 插件 解析 机 制 ， 希 望 能 使 得 读者 对 Maven 有 更 深刻 的 理解 。 


第 8 章 ”聚合 与 继承 


“account-persist 
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聚合 


继承 
聚合 与 继承 的 关系 
-约定 优 于 配置 
HE 


:小结 


在 这 个 技术 飞速 发 展 的 时 代 ， 各 类 用 户 对 软件 的 要 求 越 来 越 高 ， 软 
件 本 刁 也 变 得 越 来 越 复 汪 。 因 此 ， 软 件 设计 人 员 往 往 会 采用 各 种 方式 对 
软件 划分 模块 ， 以 得 到 更 清晰 的 设计 及 更 高 的 重用 性 。 当 把 Maven 应 用 
到 实际 项 目 中 的 时 候 ， 也 需要 将 项 目 分 成 不 同 的 模块 ， 例 如 ， 在 4.3.2 区 
中 ， 本 书 的 背景 案例 账户 注册 服务 束 被 划分 成 了 accountremail、account- 
persist 等 五 个 模块 。Maven 的 聚合 特性 能 够 把 项 目的 各 个 模块 聚合 在 一 
起 构建 ， 而 Maven 的 继承 特性 则 能 帮助 抽取 各 模块 相同 的 依赖 和 插件 等 











配置 ， 在 简化 POM 的 同时 ， 还 能 促进 各 个 模块 配置 的 一 致 性 。 本 章 将 结 


合 实际 的 案例 阐述 Maven 的 这 两 个 特性 。 


8.1 account-perslst 





在 讨论 多 模块 Maven 项 目的 聚合 与 继承 之 前 ， 本 书 先 引 入 账户 注册 
服务 的 account-persist 模 块 。 该 模块 负责 账户 数据 的 持久 化 ， 以 XML 文 
件 的 形式 保存 账户 数据 ， 并 支持 账户 的 创建 、 读 取 、 更 新 、 有 删除 等 操 
{Fe 


8.1.1 account-persist 的 POM 


首先 ， 看 一 下 account-persist 模 块 的 POM 文 件 ， 见 代码 清单 8-1。 
代码 清单 8-1 account-persist 的 POM 


<project xmlns ="http://maven. apache. org/POM/4.0.0" 
xmlns:xsi = "http://www. w3.org/2001 /XMLSchema-—instance" 

xsi:schemaLocation = "http: //maven. apache. org/POM/4.0.0 
http: //maven. apache. org/maven-v4_0_0.xsd"> 

<modelVersion >4.0.0 < /modelVersion > 

< GroupId >com. juvenxu. mvnbook. account < /groupid > 

<artifactId >account-persist < /artifactId> 

<name >Account Persist < /name > 

<version >1.0.0-SNAPSHOT < /version > 


<dependencies > 

< dependency > 
<groupid >dom4j < /groupiId > 
<artifactId>dom4j < /artifactId> 
<version >1.6.1 </version > 

< /dependency > 

< dependency > 
<groupId >org. springframework < /groupId > 
<artifactid >spring-core < /artifactId> 
<version >2.5.6 < /version > 

< /dependency > 

< dependency > 
<groupId >org. springframework < /groupId > 
<artifactid >spring-beans < /artifactid> 
<version >2.5.6 </version> 

< /dependency > 

< dependency > 
<groupId >org. springframework < /groupId > 


<artifactId >spring-context < /artifactId> 
<version >2.5.6 </version > 

< /dependency > 

< dependency > 
<groupld >junit < /groupid > 
<artifactId>junit < /artifactId > 


<version >4.7 < 


/version > 
< scope >test < /scope > 
< /dependency > 


< /dependencies > 


5 < /directory > 





<groupid >org. apache. maven. plugins < /groupId > 
<artifactId >maven-compiler-plugin < /artifactiId> 
< configuration > 
< source >1.5-< /source > 
<target >1.5 < /target > 
< /configuration > 
< /plugin > 
<plugin> 
< GroupId >orqg. apache. maven. plugins < /groupid > 
<artifactiId >maven-resources-plugin< /artifactiId> 
< configuration > 
<encoding >UTF-8 < /encoding > 
< /configuration > 
< /plugin> 
< /plugins > 
</build> 


< /project > 


该 模块 的 坐标 为 com.juvenxu.mvnbook.account: account-persist: 
1.0.0-SNAPSHOT， 回 顾 一 下 5.3.1 节 ， 读 者 就 能 发 现 ， 该 模块 groupId 和 
version 与 account-email 模 块 完 全 一 致 ， 而 且 artifactId 也 有 相同 的 前 绥 。 

一 般 来 说 ， 一 个 项 目的 子 模块 都 应 该 使 用 同样 的 groupId， 如 果 它 们 一 起 
开发 和 发 布 ， 还 应 该 使 用 同样 的 version， 此 外 ， 它 们 的 artifactId 还 应 该 
使 用 一 致 的 前 级 ， 以 方便 同 其 他 项 目 区 分 。 


POM 中 配置 了 一 些 依赖 。 其 中 ，dom4j 是 用 来 支持 XML 操 作 的 ， 接 
下 来 是 几 个 springframework 的 依赖 ， 与 account-email 中 一 样 ， 它 们 主要 
用 来 文 持 依赖 注入 ;最 后 是 一 个 测试 范围 的 junit 依 赖 ， 用 来 文 持 单元 测 
ie 


接着 是 build 元 素 ， 它 先是 包含 了 一 个 testResources 子 元 素 ， 这 是 为 
了 开启 资源 过 滤 。 稍 后 讨论 account-persist 单 元 测试 的 时 候 ， 我 们 会 详细 


I 





build 元 素 下 还 包含 了 两 个 插件 的 配置 。 首 先是 配置 maven-compiler- 
plugins¢ Java 1.5， 我 们 知道 ， 虽 然 这 里 没有 配置 插件 版 本 ， 但 由 于 
maven-compiler-plugin 是 核心 插件 ， 它 的 版 本 已 经 在 超级 POM 中 设 定 
了 。 此 外 ， 如 果 这 里 不 配置 groupId，Maven 也 会 使 用 默认 的 groupId 
org.apache.maven.plugins。 除 了 maven-compiler-plugin， 这 里 还 配置 了 


maven-resources-plugin 使 用 UTF-8 编 码 处 理 资源 文件 。 


8.1.2 ”account-persist 的 主 代码 


account-persist 的 Java 主 代码 位 于 默认 的 src/main/java 目 录 ， 包 含 
Account.java、AccountPersistService.java、AccountPersistServiceImpl.java 
和 AccountPersistException.java 四 个 文件 ， 它 们 的 包 名 都 是 
com.juvenxu.mvnbook.account.persist， 该 包 名 与 account-persist 的 groupId 


com.juvenxu.mvnbook.account 及 artifactId account-persist 对 心 。 


Account 类 定义 了 账户 的 简单 模型 ， 它 包含 id、name 等 字段 ， 并 为 
每 个 字段 提供 了 一 组 getter 和 setter 方 法 ， 见 代码 清单 8-2。 


代码 清单 8-2 Account.java 


package com. juvenxu.mvnbook. account. persist; 
public class Account 
{ 

private String id; 

private String name; 

private String email; 

private String password; 


private boolean activated; 


public String getId() 


{ 
return id; 
} 
public void setId{ String id ) 
{ 
this. id=id; 
} 


public String getName () 
{ 
return name; 
} 
public void setName ( String name ) 
{ 


this.name =name; 


//getter and setter methods for email, password and activated 


account-persist 对 外 提供 的 服务 在 接口 AccountPersistService 中 定义 ， 
其 方法 对 应 了 账户 的 增 、 删 、 改 、 碍 ， 见 代码 清单 8-3。 


代码 清单 8-3 AccountPersistService.java 


package com. juvenxu.mvnbook. account. persist; 


public interface AccountPersistService 


Account createAccount ( Account account ) throws AccountPersistException; 


Account readAccount ( String id ) throws Account PersistException; 
account ) throws AccountPersistException; 


Account updateAccount ( Account ac 


void deleteAccount ( String id ) throws AccountPersistException; 





当 增 、 删 、 改 、 碍 操作 发 生 异 常 的 时 候 ， 该 服务 则 抛 出 


AccountPersistEXception 。 


AccountPersistService 对 应 的 实现 为 AccountPersistServiceImpl， 它 通 
过 操作 XML 文件 实现 账户 数据 的 持久 化 。 首 先 看 一 下 访 类 的 两 个 私有 
方法 : readDocument () 和 writeDocument © ， 见 代码 清单 8-4。 


代码 清单 8-4 ”AccountPersistServiceImpl.java 第 1 部 分 


private String file; 
private SAXReader reader =new SAXReader (); 
private Document readDocument () throws Account PersistException 
i File dataFile =new File( file ); 
if ( !dataFile.exists() ) 
i dataFile.getParentFile().mkdirs (}; 
Document doc = DocumentFactory.getInstance ().createDocument (); 
Element rootEle =doc,. addElement ( ELEMENT ROOT ); 
rootEle. addElement ( ELEMENT_ACCOUNTS ); 


writeDocument ( doc ); 


return reader. read( new File( file) ); 


catch ( DocumentException e ) 
{ 


throw new AccountPersistException( “Unable to 


} 


private void writeDocument ( Document doc ) throws : 


out =new OutputStreamWriter (new 


XMLWriter writer =newk XMLWriter ( out, Outputl 


catch ( IOException e ) 
throw new Account PersistException [{ 
} 
finally 
try 
{ 


if ( out !=null) 


out.close(); 


} 
catch ( IOExceptione ) 


throw new AccountPersistException { 
writer", e€); 


Account Persis 


FileOutputs 


“Unable to write persist 


"Unable to close persi 


read persist data xml", e ); 


tException 


"utf-8" ); 


tream{ file ), 


ormat.createPrettyPrint () ); 


先 看 writeDocument〈) 方法 。 该 方法 首先 使 用 变量 名 e 构 建 一 个 文 
件 输出 流 ，fie 是 AccountPersistServiceImpl 的 一 个 私有 变量 ， 它 的 值 通 
过 SpringFramework 注 入 。 得 到 输出 流 后 ， 该 方法 再 使 用 DOM4J 创 建 一 
个 XMLWriter， 这 里 的 OutputFormat.createPrettyPrint () 用 来 创建 一 个 


带 缩 进 及 换行 的 友好 格式 。 得 到 XMLWriter 后 ， 


就 调用 其 write O 方 


法 ， 将 Document 写 入 到 文件 中 。 访 方法 的 其 他 代码 用 做 处 理 流 的 关闭 及 


data xml", e); 


异常 处 理 。 


readDocument () 方法 与 writeDocument O 对 应 ， 它 负责 从 文件 中 
读 取 XML 数 据 ， 也 就 是 Document 对 象 。 不 过 ， 在 这 之 前 ， 该 方法 首先 
会 检查 文件 是 否 存在 ， 如 果 不 存 在 ， 则 需要 初始 化 一 个 XML 文档 ， 于 
是 借助 DocumentFactory 创 建 一 个 Document 对 象 ， 接 着 添加 XML 元 素 ， 
再 把 这 个 不 包含 任何 账户 数据 的 XML 文档 写 入 到 文件 中 。 如 果 文 件 已 
经 被 初始 化 了 ， 则 该 方法 使 用 SAXReader 读 取 文 件 至 Document 对 象 。 








用 来 存储 账户 数据 的 XML 文件 结构 十 分 简单 ， 如 下 是 一 个 包含 一 
个 账户 数据 的 文件 ， 见 代码 清单 8-5。 


代码 清单 8-5 ”账户 数据 的 XML 文件 





这 个 XML 文件 的 根 元 素 是 account-persist， 其 下 是 accounts 元 素 ， 
accounts 可 以 包含 零 个 或 者 多 个 account 元 素 ， 每 个 account 元 素 代 表 一 个 


账户 ， 其 子 元 素 表示 该 账户 的 d、 姓 名 、 电 子 邮 件 、 密 码 以 及 是 否 被 激 








So aye 
活 等 言 轧 、 。 


现在 看 一 下 readAccount ©) 方法 是 如 何 从 XML 文档 读 取 并 构建 
Account 对 象 的 ， 见 代码 清单 8-6。 


代码 清单 8-6 ”AccountPersistServiceImpl.java 第 2 部 分 


口 
public Account readAccount ( String id ) throws AccountPersistException 
{ 


Document doc =readDocument (); 


Element accountsEle =doc.getRootElement (). element ( ELEMENT_ACCOUNTS ); 


for {Element accountEle : (List <Element >) accountsEle. elements (} ) 
t 
if ( accountEle. elementText ( ELEMENT_ACCOUNT_ID ). equals ( id ) ) 


return buildAccount ( accountEle ); 


return null; 


private Account buildAccount ( Element element ) 
Account account =new Account (); 


account. 


e 


setId( element. elementText ( ELEMENT ACCOUNT ID ) ) 
account. setN 


DU Kja 
ame { element. elementText ( ELEMENT_ACCOUNT_NAME ) }; 
account. setEmail ( element. elementText ( ELEMENT_ACCOUNT_EMAIL ) ); 


account. setPassword( element. elementText ( ELEMENT_ACCOUNT_PASSWORD ) ); 
account. setActivated( ( "true". equals ( element.elementText ( ELEMENT_ACCOUNT_ 
ACTIVATED ) ) ? true : false ) ); 


se 


return account; 





readAccount () 方法 首先 获取 XML 文档 的 Document 对 象 ， 接 着 获 
取 根 元 素 的 accounts 子 元 素 ， 这 里 的 ELEMENT_ACCOUNTS 是 一 个 静态 
和 常量， 其 值 就 是 accounts。 接 着 裔 历 accounts 的 子 元 姆 ， 如 果 当 前 子 元 素 








的 id 与 要 读 取 的 账户 的 id 一 致 ， 并 且 基 于 该 子 元 兹 构建 Account 对 象 ， 这 
也 就 是 buildAccount () 方法 。 


fEbuildAccount O 方法 中 ， 先 创建 一 个 Account 对 象 ， 然 后 当前 
XML 元 素 的 子 元 素 的 值 设置 该 对 象 。Element 的 elementText O 方法 能 
够 根据 子 元 素 名 称 返 回 子 元 素 的 值 ， 与 ELEMENT_ACCOUNTS 类 似 ， 
这 里 使 用 了 一 些 静 态 常量 表示 id、name、email 等 XML 中 的 元 素 名 称 。 
Account 对 象 设置 完 后 就 直接 返回 ， 如 果 XML 文 档 中 没有 匹配 的 d， 则 
返回 null。 











为 了 使 本 章 内 容 人 不 致 过 于 元 长 ， 这 里 就 不 再 介绍 
createAccount () 、updateAccount () 和 deleteAccount ©) 几 个 方法 的 
实现 。 感 兴趣 的 读者 可 以 参照 DOM4J 的 文档 实现 这 几 个 方法 ， 过 程 应 
该 非常 简单 。 


除了 Java 代 码 ，account-persist 模 块 还 需要 一 个 SpringFramework 的 配 
置 文件 ， 它 位 于 src/main/resources 目 录 ， 其 内 容 见 代码 清单 8-7。 


代码 清单 8-7 ”account-persist 的 Spring 配 置 文件 


<?xml version ="1.0" encoding = "UTF-8"?> 

<beans xmins = "http://www. springframework. org/schema/beans" 
xmins:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xSi:schemaLocation = "http://www. springframework. org /schema/beans 

http://www. springframework. org/schema/beans /spring-beans2.5.xsd" > 


<bean id= "propertyConfigurer" 


class = “org. springframework. beans. factory. config. PropertyPlaceholderCo- 
g. SE g Yy y 
<property name = "location" value = "classpath:account-service. proper- 
< /bean > 


<bean id = "accountPersistService" 


class = "com. juvenxu. mvnbook. account. persist.AccountPersistServicel- 


<property name = "file" value =" $ {persist.file}" /> 


< / bean > 


< /beans > 


该 配置 文件 首先 配置 了 一 个 id 为 propertyConfigurer 的 bean， 其 实现 
为 PropertyPlaceholderConfigurer， 作 用 是 从 项 目 classpath 载 入 名 为 
account-service.properties 的 配置 文件 。 随 后 的 bean 是 
accountPersistService， 实 现 为 AccountPersistServiceImpl， 同 时 这 里 使 用 
属性 persist.file 配 置 其 file 字 段 的 值 。 也 就 是 说 ，XML 数 据 文档 的 位 置 是 
由 项 目 classpath 下 account-service.properties 文 件 中 persist.file 属 性 的 值 配 
置 的 。 


8.1.3 account-persist 的 测试 代码 


定义 并 实现 了 账户 的 增 、 删 、 改 、 查 操作 ， 当 然 也 不 能 少 了 相应 的 
测试 。 测 试 代码 位 于 src/test/java/ 目 录 下 ， 测 试 资源 文件 位 于 
src/test/resources/ 目 录 下 。 上 一 节 SpringFramework 的 定义 要 求 项 目 
classpath 下 有 一 个 名 为 account-service.properties 的 文件 ， 并 且 该 文件 中 需 
要 包含 一 个 persist.file 属 性 ， 以 定义 文件 存储 的 位 置 。 为 了 能 够 测试 账户 
数据 的 持久 化 ， 在 测试 资源 目录 下 创建 属性 文件 account- 
service.properties。 其 内 容 如 下 : 


persist.file = $ {project.build.testOutputDirectory}/persist-Gata.xml 


该 文件 只 包含 一 个 persist.file 属 性 ， 表 示 存 储 账户 数据 的 文件 路 径 ， 
但 是 它 的 值 并 不 是 简单 的 文件 路 径 ， 而 是 包含 了 $ 
{project.build.testOutputDirectory}。 这 是 一 个 Maven 属 性 ， 这 里 读者 暂时 
只 要 了 解 该 属性 表示 了 Maven 的 测试 输出 目录 ， 其 默认 的 地 址 为 项 目 根 
目录 下 的 target/test-classes 文 件 夹 。 也 就 是 说 ， 在 测试 中 使 用 测试 输出 目 
录 下 的 persist-data.xml 文 件 存 储 账户 数据 。 


现在 编写 测试 用 例 测试 AccountPersistService。 同 样 为 了 避免 风 余 ， 
这 里 只 测试 readAccount O 方法 ， 见 代码 清单 8-8。 


代码 清单 8-8 AccountPersistServiceTest.java 


package com. juvenxu.mvnbook. account.persist; 


import static org. junit, Assert. *; 

import java.io.File; 

import org. junit. Before; 

import org. junit.Test; 

import org. springframework. context. ApplicationContext ; 

import org. springframework. context. support.ClassPathxXmlApplicationContext; 


public class AccountPersistServiceTest 
{ 


private AccountPersistService service; 


@ Before 
public void prepare () 
throws Exception 
{ 
File persistDataFile =new File ("target /test-classes /persist<data. xml" ); 


if (persistDataFile.exists() ) 
{ 

persistDataFile. delete (); 
} 


ApplicationContext ctx = new ClassPathXmlApplicationContext ( "account- 
persist.xml" ); 


service = (AccountPersistService) ctx. getBean( "accountPersistService” ); 


Account account =new Account (); 
account.setId("juven"); 

account. setName ("Juven Xu"); 

account. setEmail ("juven@ changeme.com"); 
account. set Password ("this_should_be encrypted"); 
account. setActivated (true); 


service. createAccount (account); 


@ Test 
public void testReadAccount {) 
throws Exception 


Account account =service. readAccount ( "juven" ); 


assertNotNull ( account ); 

assertEquals ( "juven", account.getId() ); 

assertEquals( "Juven Xu", account. getName () ); 

assertEquals( "juven@ changeme.com", account. getEmail() ); 
assertEquals( "this should be encrypted", account. cgetPassword({) ); 
assertTrue( account. isActivated() ); 





该 测试 用 例 使 用 与 AccountPersistService 一 致 的 包 名 ， 它 有 两 个 方 
法 : prepare () 与 testReadAccount () 。 其 中 prepare O 方法 使 用 了 
@Before 标 注 ， 表 示 在 执行 测试 用 例 之 前 执行 该 方法 。 它 首先 检查 数据 
存储 文件 是 否 存在 ， 如 果 存 在 则 将 其 删除 以 得 到 干净 的 测试 环境 ， 接 着 
使 用 account-persist,xml 配 置 文件 初始 化 SpringFramwork 的 IoC 容 器 ， 再 从 
容器 中 获取 要 测试 的 AccountPersistService 对 象 。 最 后 ，prepare O 方法 
创建 一 个 Account 对 象 ， 设 置 对 象 字 段 的 值 之 后 ， 使 用 


AccountPersistService 的 createAccount () 方法 将 其 持久 化 。 





使 用 @Test 标 注 的 testReadAccount O 方法 就 是 要 测试 的 方法 。 该 
方法 非常 简单 ， 它 根据 id 使 用 AccountPersistService 读 取 Account 对 象 ， 
然后 检查 该 对 象 不 为 空 ， 并 且 每 个 字段 的 值 必须 与 刚才 插入 的 对 象 的 值 
完全 一 致 。 


该 测试 用 例 齐 守 了 测试 接口 而 不 测试 实 现 这 一 原则 。 也 就 是 说 ， 训 
试 代码 不 能 引用 实现 类 ， 由 于 测试 是 从 接口 用 户 的 角度 编写 的 ， 这 样 束 
能 保证 接口 的 用 户 无 须知 晓 接口 的 实现 细 市 ， 既 保证 了 代码 的 解 厢 ， 也 
促进 了 代码 的 设计 。 





8.2 RE 

到 目前 为 止 ， 本 书 实 现 了 用 户 注 册 服 务 的 两 个 模块 ， 它 们 分 别 是 第 
5 章 实 现 的 account-email 和 本 章 实 现 的 account-persist。 这 时 ， 一 个 简单 
的 需求 就 会 自然 而 然 地 显现 出 来 : 我 们 会 想 要 一 次 构建 两 个 项 目 ， 而 不 
是 到 两 个 模块 的 目录 下 分 别 执行 mvn 命 令 。Maven 聚 合 〈 或 者 称 为 多 模 
块 ) 这 一 特性 就 是 为 该 需求 服务 的 。 


为 了 能 够 使 用 一 条 命令 就 能 构建 account-email 和 account-persist 两 个 
模块 ， 我 们 需要 创建 一 个 额外 的 名 为 accountraggregator 的 模块 ， 然 后 通 
过 该 模块 构建 整个 项 目的 所 有 模块 。account-aggregator 本 里 作为 一 个 
Maven 项 目 ， 它 必须 要 有 自己 的 POM， 不 过 ， 同 时 作为 一 个 聚合 项 目 ， 
其 POM 又 有 特殊 的 地 方 。 如 下 为 account-aggregator 的 pom.xml 内 容 ， 见 
代码 清单 8-9。 





代码 清单 8-9 ”account-aggregator 的 POM 


xmins ="http://maven. apache. org/POM7/4.0.0" 










rg 7/2001 /XMLSchema-instance 
na mache. org/POM/4.0.0 





< pac kaging > pc OM < , aging 


“name > Account Aggregator < /name > 


<module 
< od 1 e >account-emāil < /module > 
< module >account-persist < /module > 
< /modules > 
‘project > 


上 述 POM 依 旧 使 用 了 账户 注册 服务 共同 的 groupId 
com.juvenxu.mvnbook.account，artifactId 为 独立 的 account-aggregator， 版 
本 也 与 其 他 两 个 模块 一 致 ， 为 1.0.0-SNAPSHOT。 这 里 的 第 一 个 特殊 的 
地 方 为 packaging， 其 值 为 POM。 回 顾 account-email 和 account-persist， 它 
们 都 没有 声明 packaging， 即 使 用 了 默认 值 jar。 对 于 聚合 模块 来 说 ， 其 打 
包 方 式 packaging 的 值 必须 为 pom， 人 否则 就 无 法 构建 。 


POM 的 name 字 段 是 为 了 给 项 目 提 供 一 个 更 容易 阅读 的 名 字 。 之 后 
是 本 书 之 前 都 没 提 到 过 的 元 素 modules， 这 是 实现 聚合 的 最 核心 的 配 
置 。 用 户 可 以 通过 在 一 个 打包 方式 为 pom 的 Maven 项 目 中 声明 任意 数量 
的 module 元 素来 实现 模块 的 聚合 。 这 里 每 个 module 的 值 都 是 一 个 当前 
POM 的 相对 目录 ， 壁 如 该 例 中 ，account-aggregator 的 POM 的 路 径 为 D: \ 








...\code\ch-8\account-aggregator\pom.xml, ABA account-email ih xt IY y A 
KD: \...\code\ch-8\account-aggregator\account-email/, 而 account-persist 


对 应 于 目录 D: \...\code\ch-8\account-aggregator\account-persist/. 1% PY“ 





目录 各 上 自 包 含 了 pom.xml、srcmain/java/、src/tesUVjava/ 等 内 容 ， 离 开 








account-aggregator 也 能 独立 构建 。 


一 般 来 说 ， 为 了 方便 快速 定位 内 容 ， 模 块 所 处 的 目录 名 称 应 当 与 其 
artifactId 一 致 ， 不 过 这 不 是 Maven 的 要 求 ， 用 户 也 可 以 将 account-email 项 
目 放 到 email-account/ 目 录 下 。 这 时 ， 聚 合 的 配置 就 需要 相应 地 改 成 


<module>email-account</module>. 











AS FEA PES, GA RG BUR ELA A Se UE 
SRR MITE AZE GERI TOA SAE TE, ROPE HA AAH, 
第 一 眼 发 现 的 就 是 聚合 模块 的 POM， 不 用 从 多 个 模块 中 去 寻找 聚合 模块 
来 构建 整个 项 目 。 图 8-1 所 示 为 accountraggregator 与 另外 两 个 模块 的 目录 
结构 关系 。 





从 图 8-1 中 能 够 看 到 ，account-aggregator 的 内 容 仅 是 一 个 pom.xml 文 
件 ， 它 不 像 其 他 模块 那样 有 src/main/java、src/test/java 等 目录 。 这 也 是 容 
易 理 解 的 ， 聚 合 模块 仅仅 是 帮助 聚合 其 他 模块 构建 的 工具 ， 它 本 和 喘 并 无 
实质 的 内 容 。 








关于 目录 结构 还 需要 注意 的 是 ， 吧 合 模块 与 其 他 模块 的 目录 结构 并 
非 一 定 要 是 父子 关系。 图 8-2 展 示 了 为 一 种 平行 的 目录 结构 。 





(t+ account-aggregator 
ma JRE System Library {jre1.6.0_¢ 
G account-email 


& src 

© target 

‘ml pom.xml 
E> account-persist 

& src 

& target 

上 pom.xml 
m pom.xml 





图 8-1 聚合 模块 的 父子 目录 结构 


4 (>œ account-aggregator 
m) pom.xml 
4 (=, account-email 


G src 
» @ target 


向 pom.xml 
4 (Sœ account-persist 


& src 
> © target 
m| pom.xml 





图 8-2 ”聚合 模块 的 平行 目录 结构 


如 琳 使 用 平行 目录 结构 ， 聚 合 模 块 的 POM 也 需要 做 相应 的 修改 ， 以 
指 癌 正确 的 模块 目录 : 


<modules > 
<module . /account-email < /module 
i . /account-persist < 2 
< /modules > 





最 后 ， 为 了 得 到 直观 的 感受 ， 看 一 下 从 聚合 模块 运行 mvn clean 








install 命 令 会 得 到 怎样 的 输出 : 


[INFO] 
[INFO] 
[INFO] 
[INFO] 


Scanning for projects... 
Reactor Build Order: 
] 


[INFO] Account Aggregator 
[INFO] Account Email 


[INFO] 


[INFO 


[INFO] 


[INFO] 


Account Persist 


] 


OO] Building Account Email 1.0.0-SNAPSHOT 
[INFO] ------------------------------------------------------------- 


[INFO 


[INFO] 
[INFO] 


[INFO 


De AE E E pl BL a A EAE EEE E 
Building Account Persist 1.0.0-SNAPSHOT 


) ws 


[INFO] 一 一 -一 一 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Reactor Summary: 
[INFO] 


[INFO 
[INFO 


] Account Aggregator „seses sses ses SUCCESS [0.4965] 
] Account Email. sranna E oe SSB 


[INFO] Account Persist Wea SUCCESS 2176s] 


[INFO 


] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


[INFO] BUILD SUCCESS 


[INFO 


[INFO] 
[INFO] 


Yee ee tp E A E eee ener ee eee EEE AE EE E EE E 
Total time: 6.158s 
Finished at: Sun Feb 14 16:36:29 CST 2010 


[INFO] Final Memory: 11M/20M 
[INFO] ----=—-s- +e eH es 


会 目 先 解析 聚 合 模 块 的 POM、 分 析 要 构建 的 模块 、 并 计算 出 一 个 反 


应 堆 构 建 顺序 (Reactor Build Order) ， 然 后 根据 这 个 顺序 依次 构建 各 个 


模块 。 反 应 堆 是 所 有 模块 组 成 的 一 个 构建 结构 。8.6 节 会 详细 讲述 Maven 
的 反应 堆 。 





上 述 得 出 中 显示 的 是 各 模块 的 名 称 ， 而 不 是 artifactd， 这 也 解释 了 
为 什么 要 在 POM 中 配置 合理 的 name 字 段 ， 其 目的 是 让 Maven 的 构建 输出 
更 清晰 。 输 出 的 最 后 是 一 个 项 目 构建 的 小 结 报告 ， 包 括 各 个 模块 构建 成 
功 与 个、 花费 的 时 间 ， 以 及 整个 构建 花费 的 时 间 、 使 用 的 内 存 等 。 


8.3 继承 


到 目前 为 止 ， 我 们 已 经 能 够 使 用 Maven 的 聚合 特性 通过 一 条 命令 同 
时 构建 account-email 和 account-persist 两 个 模块 ， 不 过 这 仅仅 解雇 了 多 模 
块 Maven 项 目的 一 个 问题 。 那 么 多 模块 的 项 目 还 有 什么 问题 呢 ? 


细心 的 读者 可 能 已 经 比较 过 5.3.1 站 和 8.1.1 六 ， 这 两 个 OM 有 着 很 多 
相同 的 配置 ， 例 如 它们 有 相同 的 groupId 和 version， 有 相同 的 Spring- 
core、Sspring-beans、spring-context 和 junit 依 赖 ， 还 有 相同 的 maven- 





compiler-plugin 与 maven-resources-plugin 配 置 。 程 序 员 的 嗅觉 对 这 种 现象 
比较 敏感 ， 没 错 ， 这 是 重复 ! 大 量 的 前 人 经 验 告诉 我 们 ， 重 复 往往 就 意 
味 着 更 多 的 劳动 和 更 多 的 潜在 的 问题 。 在 面向 对 象 世界 中 ， 程 序 员 可 以 
使 用 类 继承 在 一 定 程 度 上 消除 重复 ， 在 Maven 的 世界 中 ， 也 有 类 似 的 机 
制 能 让 我 们 抽取 出 重复 的 配置 ， 这 就 是 POM 的 继承 。 





8.3.1 account-parent 


面向 对 象 设 计 中 ， 程 序 员 可 以 建立 一 种 类 的 父子 结构 ， 然 后 在 父 类 
中 声明 一 些 字段 和 方法 供 子 类 继承 ， 这 样 就 可 以 做 到 “一 处 声明 ， 多 处 
使 用 ”。 类 似 地 ， 我 们 需要 创建 POM 的 父子 结构 ， 然 后 在 父 POM 中 声明 
一 些 配 置 供 子 POM 继 承 ， 以 实现 “一 处 声明 ， 多 处 使 用 ”的 目的 。 


我 们 继续 以 账户 注册 服务 为 基础 ， 在 account-aggregator 下 创建 一 个 
名 为 account-parent 的 子 目 录 ， 然 后 在 该 子 目 录 下 建立 一 个 所 有 除 
account-aggregator 之 外 模块 的 父 模块 。 为 此 ， 在 该 子 目录 创建 一 个 
pom.xml 文 件 ， 内 容 见 代码 清单 8-10。 


代码 清单 8-10 account-parent 的 POM 


<project xmlns ="http://maven. apache. org/POM/4.0.0" 
xmins:xsi = "http: 《LAwww. w3.org/2001 /XMLSc he ma-instance" 

xsi:schemaLocation = TE apache. org /POM M/4. 
http://maven.apac he: org /maven-v 400. é xa" > 

<modelVersion >4.0.0 < /modelVersix 

<groupId >com. juvenxu.mvnbook. account < /groupId > 

<artifactId >account-parent < /arti ant ta > 

version >1.0.0-SNAPSHOT < /version > 
<packaging >pom< /packaging > 
<name >Account Parent < /name > 








< /project > 


该 POM 十 分 简单 ， 它 使 用 了 与 其 他 模块 一 致 的 groupId 和 version， 
使 用 的 artifactId 为 account- 是 一 个 父 模块 。 需 要 特别 注意 的 
是 ， 它 的 packaging 为 pom， 这 一 点 与 聚合 模块 一 样 ， 作 为 父 模块 的 





POM， 其 打包 类 型 也 必须 为 pom。 


由 于 父 模块 只 是 为 了 帮助 消除 配置 的 重复 ， 因 此 它 本 身 不 包含 除 
POM 之 外 的 项 目 文件 ， 也 就 不 需要 src/main/java/ 之 类 的 文件 夹 了 。 





有 了 父 模 块 ， 束 需要 让 其 他 模块 来 继承 它 。 首 先 将 account-email 的 
POM 修 改 如 下 ， 见 代码 清单 8-11。 





代码 清单 8-11 修改 accountremail 继 承 account-parent 


<project xmlns = "http://maven. apache.org/POM/4.0.0" 
xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
3i:schemaLocation = "http: //maven. apache. org/POM/4.0.0 





http: //maven. apache. org/maven-v4_0_0.xsd"> 
<modelVersion >4.0.0 < /modelVersion > 
<parent > 
<groupId >com. juvenxu.mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId > 
<version >1.0.0-SNAPSHOT < /version > 
<relativePath >../account-parent /pom. xml < /relativePath > 


< /parent > 


<artifactId >account-email < /artifactId> 
<name >Account Email < /name > 


< dependencies > 


<plugins > 


< /plugins > 


< /build> 


< /project > 


上 述 POM 中 使 用 parent 元 素 声 明 父 模块 ，parent 下 的 子 元 素 
groupId、artifactId 和 version 指 定 了 父 模块 的 坐标 ， 这 三 个 元 素 是 必须 


的 。 元 素 relativePath 表 示 父 模块 POM 的 相对 路 径 ， 该 例 中 的 .account- 
parent/pom.xml 表 示 父 POM 的 位 置 在 与 account-email/ 目 录 平 行 的 account- 
parent/ 目 录 下 。 当 项 目 构建 时 ，Maven 会 首先 根据 relativePath 检 查 父 
POM， 如 果 找 不 到 ， 再 从 本 地 仓库 查找 。relativePath 的 默认 值 

是 ./pom.xml， 也 就 是 说 ，Maven 默 认 父 POM 在 上 一 层 目录 下 。 


正确 设置 relativePath 非 常 重 要 。 考 虑 这 样 一 个 情况 ， 开 发 团队 的 新 
成 员 从 源码 库 签 出 一 个 包含 父子 模块 关系 的 Maven 项 目 。 由 于 只 关心 其 
中 的 某 一 个 子 模块 ， 它 就 直接 到 该 模块 的 目录 下 执行 构建 ， 这 个 时 候 ， 
父 模 块 是 没有 被 安装 到 本 地 仓库 的 ， 因 此 如 果子 模块 没有 设置 正确 的 
relativePath，Maven 将 无 法 找到 父 POM， 这 将 直接 导致 构建 失败 。 如 果 
Maven 能 够 根据 relativePath 找 到 父 POM， 它 就 不 需要 再 去 检查 本 地 仓 
库 。 





这 个 更 新 过 的 POM 没 有 为 account-email 声 明 groupId 和 version， 不 过 
这 并 不 代表 account-email 没 有 groupId 和 version。 实 际 上 ， 这 个 子 模块 隐 
式 地 从 父 模 块 继 承 了 这 两 个 元 素 ， 这 也 就 消除 了 一 些 不 必要 的 配置 。 在 
该 例 中 ， 父 子 模块 使 用 同样 的 groupId 和 version， 如 果 遇 到 子 模块 需要 使 
用 和 父 模块 不 一 样 的 groupId 或 者 version 的 情况 ， 那 么 用 户 完 全 可 以 在 子 
模块 中 显 式 声明 。 对 于 artifactId 元 系 来 说 ， 子 模块 应 该 显 式 声明 ， 一 方 
面 ， 如 果 完 全 继承 groupId、artifactId 和 version， 会 造成 坐标 冲突 ; 另 一 
方面 ， 即 使 使 用 不 同 的 groupId 或 version， 同 样 的 artifactId 容 易 造 成 混 








W 


为 了 节省 篇 幅 ， 上 述 POM 中 省 略 了 依赖 配置 和 插件 配置 ， 稍 后 本 章 
会 介绍 如 何 将 共同 的 依赖 配置 提取 到 父 模块 中 。 


与 account-email 的 POM 类 似 ， 以 下 是 account-persist 更 新 后 的 POM， 
见 代 码 清单 8-12。 


代码 清单 8-12 ”修改 account-persist 继 承 account-parent 


<project xmlns = "http://maven. apache. org/POM/4.0.0" 
xmins:xsi = "http://www.w3.org/2001 /XMLSchema-instance" 

xsi:schemaLocation = “http://maven. apache. org/POM/4.0.0 
http: //maven,. apache. org/maven-v4_0_0.xsd"> 

<modelVersion >4.0.0 < /modelVersion > 


<parent > 
< groupiId >com. juvenxu.mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId > 
<version >1.0.0-SNAPSHOT < /version > 
<relativePath>../account-parent /pom. xml < /relativePath > 
< /parent > 
<artifactId >account-persist < /artifactid> 
<name >Account Persist < /name > 


< dependencies > 
< /dependencies > 


<build> 
<testResources > 
<testResource > 
<directory >src/test /resources < /directory > 
< filtering >true < /filtering > 
< /testResource > 
< /testResources > 


<plugins > 


< /plugins > 
</build> 


< /project > 


最 后 ， 同 样 还 需要 把 account-parent 加 入 到 聚合 模块 account- 


aggregator 中 ， 见 代码 清单 8-13。 
代码 清单 8-13 ”将 account-parent 加 入 到 聚合 模块 


<project xmlns = "http: //maven. apache. org/POM/4.0.0" 
xmlns:xsi = "http://www. w3.org/2001 /XMLSchema-nstance" 
xSi:schemaLocation = "http://maven. apache. org/POM/4.0.0 
http: //maven. apache. org /maven-v4_0_0.xsd" > 
<modelVersion >4.0.0 < /modelVersion > 
<groupid >com. juvenxu.mvnbook. account < /groupId > 
<artifactiId >account-aggregator < /artifactId> 
<version >1.0.0-SNAPSHOT < /version > 
< packaging >pom < /packaging > 
<name >Account Aggregator < /name > 
<modules > 
<module >account-parent < /module > 
<module >account-email < /module > 
<module >account-persist < /module > 
< /modules > 


8.3.2 ”可 继承 的 POM 元 素 


在 上 一 节 我 们 看 到 ，groupId 和 version 是 可 以 被 继承 的 ， 那 么 


还 有 哪 


些 POM 元 素 可 以 被 继承 昵 ? 以 下 是 一 个 完整 的 列表 ， 并 附 帝 了 简单 的 说 


明 : 


"groupId: 项 目 组 ID， 项 目 坐 标的 核心 元 素 。 





‘version: 项 目 版 本 ,项 目 坐 标的 核心 元 素 。 


“description: 项 目的 描述 信息 
“organization: 项 目的 组 织 信息 
"inceptionYear: 项 目的 创始 年 份 。 
‘url: 项 目的 URL 地 址 。 


developers: 项 目的 开发 者 信息 。 





‘contributors: 项 目的 贡献 者 信息 。 


-distributionManagement: 项 目的 部 署 配 置 。 


'issueManagement: 项 目的 缺陷 跟踪 系统 信息 。 


-ciManagement: 项 目的 持续 集成 系统 信息 。 
‘scm: 项 目的 版 本 控制 系统 信息 。 
‘mailingLists: 项 目的 邮件 列表 信息 。 
‘properties: 自 定义 的 Maven 属 性 。 
.dependencies: 项 目的 依赖 配置 。 
-dependencyManagement: 项 目的 依赖 管理 配置 。 
‘repositories: 项 目的 仓库 配置 。 


‘build: 包括 项 目的 源码 目录 配置 、 输 出 目录 配置 、 插 件 配 置 、 插 
件 管理 配置 等 。 


‘reporting: 包括 项 目的 报告 输出 目录 配置 、 报 告 插件 配置 等 。 





8.3.3 ”依赖 管理 





上 一 节 的 可 继承 元 素 列 表 包 含 了 dependencies 元 素 ， 说 明 依 赖 是 会 
被 继承 的 ， 这 时 我 们 就 会 很 容易 想到 将 这 一 特性 应 用 到 account-parent 
中 。 子 模块 account-email 和 account-persist 同 时 依赖 了 
org.springframework: spring-core: 2.5.6、org.springframework: spring- 
beans: 2.5.6、org.springframework: spring-context: 2.5.6 和 junit: junit: 
4.7， 因 此 可 以 将 这 些 依赖 配置 放 到 父 模块 account-parent 中 ， 两 个 子 模块 
就 能 移 除 这 些 依赖 ， 简 化 配置 。 


上 述 做 法 是 可 行 的 ， 但 却 存在 问题 。 到 目前 为 止 ， 我 们 能 够 确定 这 
两 个 子 模块 都 包含 那 四 个 依赖 ， 不 过 我 们 无 法 确定 将 来 添加 的 子 模块 就 
一 定 需 要 这 四 个 依赖 。 假 设 将 来 项 目 中 需要 加 入 一 个 accountrutil 模 块 ， 
该 模块 只 是 提供 一 些 简单 的 帮助 工具 ， 与 Springframework 完 全 无 关 ， 难 
道 也 让 它 依 赖 spring-core、spring-beans 和 spring-context 吗 ? 那 显 然 是 不 
合理 的 。 


Maven 提 供 的 dependencyManagement 元 素 既 能 让 子 模块 继承 到 父 模 
块 的 依赖 配置 ， 又 能 保证 子 模块 依赖 使 用 的 灵活 性 。 在 
dependencyManagement 元 素 下 的 依赖 声明 不 会 引入 实际 的 依赖 ， 不 过 它 
能 够 约束 dependencies 下 的 依赖 使 用 。 例 如 ， 可 以 在 account-parent 中 加 


入 这 样 的 dependencyManagement 配 置 ， 见 代码 清单 8-14。 


代码 清单 8-14 ”在 account-parent 中 配置 dependencyManagement 元 素 


<project 

xmlns ="http://maven.apache.org/POM/4.0.0" 

xmlns:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xSi:schemaLocation = "http: //maven. apache. org/POM/4.0.0 


http: //maven. apache. org /maven-v4_0_0.xsd" > 
<modelVersion >4.0.0 < /modelVersion > 
<groupid >com. juvenxu. mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactid> 
<version >1.0.0-SNAPSHOT < /version > 
<packaging > pom < /packaging > 
<name >Account Parent < /name > 
<properties > 
<springframework. version >2.5.6 < /springframework, version > 
< junit. version >4.7 </junit. version > 
< /properties > 
< dependencyManagement > 
<dependencies > 
< dependency > 
<groupid>org. springframework < /groupId > 
<artifactiId>spring-core < /artifactId > 
<version> $ ispringframework. version} < /version > 
< /dependency > 
< dependency > 
<groupId >org. springframework < /group!d > 
<artifactId >spring-beans < /artifactId> 
<version > $ (springframework, version} < /version > 
< /dependency > 
< dependency > 
<groupid >org, springframework < /groupid > 
<artifactId>spring-context < /artifactId > 
<version > $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<groupid >org. springframework < /groupid > 
<artifactId >spring-context-support < /artifactId> 
<version > $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<groupld>junit < /groupld > 
<artifactId>junit < /artifactId> 
<version > $ (junit. version} < /version > 
<scope >test < /scope > 
< /dependency > 
< /dependencies > 
< /dependencyManagement > 
</project > 


首先 该 父 POM 使 用 了 5.9.2 市 介绍 的 方法 ， 将 springframework 和 junit 
依赖 的 版 本 以 Maven 变 量 的 形式 提取 了 出 来 ， 不 仪 消除 了 一 些 重复 ， 也 
使 得 各 依赖 的 版 本 处 于 更 加 明显 的 位 置 。 


这 里 使 用 dependencyManagement 声 明 的 依赖 既 不 会 给 account-parent 
引入 依赖 ， 也 不 会 给 它 的 子 模块 引入 依赖 ， 不 过 这 段 配置 是 会 被 继承 
的 。 现 在 修改 account-email 的 POM 如 下 ， 见 代码 清单 8-15。 


代码 清单 8-15 ”继承 了 dependencyManagement 的 account-email POM 





<greenmail.version >1.3.1b< /greenmail.version > 
< /properties > 


< dependencies > 
< dependency > 
<groupId >org. springframework < /groupId > 
<artifactId >spring-core < /artifactId > 
< /dependency > 
< dependency > 
<groupid >org. springframework < /groupId > 
<artifactId >spring—beans < /artifactId> 
< /dependency > 
< dependency > 
<groupid >org. springframewo seas bee oupiId > 
<artifactId >spring-context < rtifactiId > 
< /dependency > 
< dependency > 
< Groupid >org. springframework < /groupId > 
<artifactId >spring-context-support < /artifactId> 
< /dependency > 
< oe ete idency > 
<groupld > < /groupld > 
RE REIR junit < /artifactid > 
< /dependency > 
< dependency > 
<groupid > javax.mail < / ple Sia 
<artifactId>mail < ga ifact 
<version> $ {javax.mail.version a < /version > 
< /dependency > 
< dependency > 
< Shen pears com. icegreen < /groupIG > 
cartifactid >greenmail < /artifactiId> 
<version> $ {greenmail. version} < /version > 
<scope >test < /scope > 
: /dependency > 
< /dependencies > 


上 述 POM 中 的 依赖 配置 较 原 来 简单 了 一 些 ， 所 有 的 springframework 
依赖 只 配置 了 groupId 和 artifacttd， 省 去 了 version， 而 junit 依 赖 不 仅 省 去 
了 version， 还 省 去 了 依赖 范围 scope。 这 些 信 息 可 以 省 略 是 因为 account- 
email 继 承 了 account-parent 中 的 dependencyManagement 配 置 ， 完 整 的 依赖 

声明 已 经 包含 在 父 POM 中 ， 子 模块 只 需要 配置 简单 的 groupId 和 artifactId 
就 能 获得 对 应 的 依赖 信息 ， 从 而 引入 正确 的 依赖 。 





使 用 这 种 依赖 管理 机 制 似乎 不 能 减少 太 多 的 POM 配 置 ， 不 过 笔者 还 
征 强 烈 推荐 采用 这 种 方法 。 其 主要 原因 在 于 在 父 POM 中 使 用 
dependencyManagement 声 明 依赖 能 够 统一 项 目 范 围 中 依赖 的 版 本 ， 当 依 
赖 版 本 在 父 POM 中 声明 之 后 ， 子 模块 在 使 用 依赖 的 时 候 就 无 须 声 明 版 
本 ， 也 束 不 会 及 生 多 个 子 模块 使 用 依赖 版 本 不 一 致 的 情况 。 这 可 以 帮助 
降低 依赖 冲突 的 几率 。 





如 果子 模块 不 声明 依赖 的 使 用 ， 即 使 该 依赖 已 经 在 父 POM 的 
dependencyManagement 中 声明 了 ， 也 不 会 产生 任何 实际 的 效果 ， 如 
account-persist 的 POM， 见 代码 清单 8-16。 


代码 清单 8-16 ”继承 了 dependencyManagement 的 account-persist 


POM 


<properties > 
<dom4j.version >1.6.1< /dom4j. version > 


< /properties > 


< dependencies > 
< dependency > 
<groupId >dom4j < / gempa > 
<artifactId >dom4j < /artifactId> 
on > $ {dom4 aie sion} < /version > 





< dependency > 
<groupid >org. springframework < /groupId > 
<artifactid >spring-core < /artifactId> 
< /dependency > 
< dependency > 
<gro up a>org. springframework < /groupId > 
-Id >spring-beans < /artifactid > 






<art ifa 


2 deh icy > 
< groupid >org. springframework < /groupiId > 
c<artifactid >spring-context < /artifactid > 
“ /dependency > 
< dependency > 
<groupid > junit < /groupld > 
<artifactId >junit </artifactid> 
< /depende 
< /depen season > 


这 里 没有 声明 spring-contextrsupport， 那 么 该 依赖 就 不 会 被 引入 。 这 
正 是 dependencyManagement 的 灵活 性 所 在 。 


5.5 节 在 介绍 依赖 范围 的 时 候 提 到 了 名 为 import 的 依赖 范围 ， 推 迟到 
现在 介绍 是 因为 该 范围 的 依赖 只 在 dependencyManagement 元 素 下 才 有 效 
果 ， 使 用 该 范围 的 依赖 通常 指向 一 个 POM， 作 用 是 将 目标 POM 中 的 
dependencyManagement 配 置 导 入 并 合并 到 当前 POM 的 
dependencyManagement 元 素 中 。 例 如 想 要 在 另外 一 个 模块 中 使 用 与 代码 
清单 8-14 完 全 一 样 的 dependencyManagement 配 置 ， 除 了 复制 配置 或 者 继 
承 这 两 种 方式 之 外 ， 还 可 以 使 用 import 范 围 依 赖 将 这 一 配置 导入 ， 见 代 





码 清 单 8-17。 


代码 清单 8-17 ”使 用 import 范 围 依赖 导入 依赖 管理 配置 


<dependencyManagement > 
< dependencies > 


< dependency > 





<groupid > com. juv 
<artifactI 


<version>] 


vnbook. account < /groupId > 
count-parent < /artifactId > 

< type >pom < / 

< scope > import < /scope > 
< /dependency > 


< /dependencies > 


< /GependencyManagement > 


注意 ， 上 述 代码 中 依赖 的 type 值 为 popm，import 范 围 依赖 由 于 其 特殊 
性 ， 一 般 都 是 指向 打包 类 型 为 pom 的 模块 。 如 果 有 多 个 项 目 ， 它 们 使 用 
的 依赖 版 本 都 是 一 致 的 ， 则 就 可 以 定义 一 个 使 用 dependencyManagement 
专门 管理 依赖 的 POM， 然 后 在 各 个 项 目 中 导入 这 些 依赖 管理 配置 。 





8.3.4 插件 管理 


Maven 提 供 了 dependencyManagement 元 素 帮 助 管理 依赖 ， 类 似 地 ， 
Maven 也 提供 了 pluginManagement 元 素 帮 助 管理 插件 。 在 该 元 素 中 配置 
的 依赖 不 会 造成 实际 的 插件 调用 行为 ， 当 POM 中 配置 了 真正 的 plugin 元 
素 ， 并 且 其 groupId 和 artifactId 与 pluginManagement 中 配置 的 插件 匹配 
时 ，pluginManagement 的 配置 才 会 影响 实际 的 插件 行为 。 


7.4.2 节 中 配置 了 maven-source-plugin， 将 其 jar-no-fork 目 标 绑 定 到 了 
verity 生 命 周 期 阶段 ， 以 生成 项 目 源码 包 。 如 果 一 个 项 目 中 有 很 多 子 模 
块 ， 并 且 需 要 得 到 所 有 这 些 模块 的 源码 包 ， 那 么 很 显然 ， 为 所 有 模块 重 
复 类 似 的 插件 配置 不 是 最 好 的 办 法 。 这 时 更 好 的 方法 是 在 父 POM 中 使 用 
pluginManagement 配 置 插件 ， 见 代码 清单 8-18。 


代码 清单 8-18 在 父 POM 中 配置 pluginManagement 


<build> 
<pluginManagement > 
<plugins > 
<plugin > 

<groupid >org. apache. maven. plugins < /groupId > 

<artifactId >maven-source-plugin < /artifactId> 

<version >2.1.1</version > 

<executions > 

<execution > 
<id>attach-sources < /id> 
<phase >verify < /phase > 
<goals > 
<goal > jar-no-fork < /goal > 
< /goals > 
< f/execution > 
< f/executions > 
< /plugin > 
< /plugins > 
< /pluginManagement > 
< /build> 


当 子 模块 需要 生成 源码 包 的 时 候 ， 只 需要 如 下 简单 的 配置 ， 见 代码 


清单 8-19。 
代码 清单 8-19 ”继承 了 pluginManagement 后 的 插件 配置 


<build> 
< plugins > 
<plugin> 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactiId >maven-source-plugin < /artifactId> 
< /plugin > 
< /plugins > 


< /build> 





子 模块 声明 使 用 了 maven-source-plugin 插 件 ， 同 时 又 继承 了 父 模块 
的 pluginManagement 配 置 ， 两 者 基于 groupId 和 artifactId 匹 配合 并 之 后 就 
相当 于 7.4.2 节 中 的 插件 配置 。 


如 果子 模块 不 需要 使 用 父 模块 中 pluginManagement 配 置 的 插件 ， 可 


以 尽管 将 其 忽略 。 如 果子 模块 需要 不 同 的 插件 配置 ， 则 可 以 自行 配置 以 


敌 新 父 模 块 的 pluginManagement 配 置 。 


有 J 了 pluginManagement 元 素 ，account-email 和 account-persist 的 POM 
也 能 得 以 简化 了 ， 它 们 都 配置 了 maven-compiler-plugin 和 maven- 
resources-plugin。 可 以 将 这 两 个 插件 的 配置 移 到 account-parent 的 


pluginManagement 元 素 中 ， 见 代码 清单 8-20。 


代码 清单 8-20 ”account-parent 的 pluginManagement 配 置 








<build> 
<pluginManagement > 
<plugins > 
<plugin > 
< groupId >org. apache. maven. plugins < /groupId > 
Fa naven-compiler-plugin < /artifactId > 





plugin 
lugin 
<groupId >org.apache. maven. plugins < /groupId > 


<artifactId >maven-resources-plugin < /artifactId> 
< configuration > 


< encoding > UTF-8 < /encoding > 








figuration > 
¢ /plugin > 
< /plugins > 
< /pluginManagement > 


- fh ] 
< 7 DULLG > 


account-email 和 account-persist 可 以 完全 地 移 除 关于 maven-compiler- 
plugin 和 maven-resources-plugin 的 配置 ， 但 它们 仍 能 享受 这 两 个 插件 的 
服务 ， 前 一 插件 开启 了 Java 5 编译 的 支持 ， 后 一 插件 也 会 使 用 UTF-8 编 
码 处 理 资源 文件 。 这 背后 涉及 了 很 多 Maven 机 制 ， 首 先 ， 内 置 的 插件 绑 


定 关 系 将 两 个 插件 绑 定 到 了 account-email 和 account-persist 的 生命 周期 
上 ; 其 次 ， 超 级 POM 为 这 两 个 插件 声明 了 版 本 ; 最 后 ，account-parent 中 
的 pluginManagement 对 这 两 个 插件 的 行为 进行 了 配置 。 


当 项 目 中 的 多 个 模块 有 同样 的 插件 配置 时 ， 应 当 将 配置 移 到 父 POM 
的 pluginManagement 元 素 中 。 即 使 各 个 模块 对 于 同一 插件 的 具体 配置 不 
尽 相 同 ， 也 应 当 使 用 父 POM 的 pluginManagement 元 素 统一 声明 插件 的 版 
本 。 甚 至 可 以 要 求 将 所 有 用 到 的 插件 的 版 本 在 父 POM 的 
pluginManagement 元 素 中 声明 ， 子 模块 使 用 插件 时 不 配置 版 本 信息 ， 这 
么 做 可 以 统一 项 目的 插件 版 本 ， 避 免 潜 在 的 插件 不 一 致 或 者 不 稳定 问 
题 ， 也 更 易于 维护 。 





8.4 KA GMKINKA 





基于 前 面 三 节 的 内 容 ， 读 者 可 以 了 解 到 ， 多 模块 Maven 项 目 中 的 聚 
合 与 继承 其 实 是 两 个 概念 ， 其 目的 完全 是 不 同 的 。 前 者 主要 是 为 了 方便 
快速 构建 项 目 ， 后 者 主要 是 为 了 消除 重复 配置 。 








对 于 聚合 模块 来 说 ， 它 知道 有 哪些 被 聚合 的 模块 ， 但 那些 被 聚合 的 
模块 不 知道 这 个 聚合 模块 的 存在 。 


对 于 继承 关系 的 父 POM 来 说 ， 它 不 知道 有 哪些 子 模块 继承 于 它 ， 但 
那些 子 模块 都 必须 知道 自己 的 父 POM 是 什么 


如 果 非 要 说 这 两 个 特性 的 共同 点 ， 那 么 可 以 看 到 ， 聚 合 POM 与 继承 
关系 中 的 父 FOM 的 packaging 都 必须 是 pom， 同 时 ， 有 聚合 模块 与 继承 关系 
中 的 父 模 块 除 了 POM 之 外 都 没有 实际 的 内 容 ， 如 图 8-3 所 示 。 


被 聚合 模块 






| e 
we | Mag 


图 8-3 ”聚合 关系 与 继承 关系 的 比较 





在 现 有 的 实际 项 目 中 ， 读 者 往往 会 发 现 一 个 POM 既 是 聚合 POML， 





又 是 父 POM， 这 么 做 主要 是 为 了 方便 。 一 般 来 说， 融合 使 用 聚合 与 继承 
也 没有 什么 问题 ， 例 如 可 以 将 accountraggregator 和 account-parent 合 并 成 
一 个 新 的 account-parent， 其 POM 见 代码 清单 8-21。 


代码 清单 8-21 合并 聚合 和 继承 功能 后 的 account-parent 


<project xmlns = 


"http: //maven. apache. org/POM/4.0,0" 
xmin 


$:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xSi:schemaLocation = "http: //maven. apache. org/POM/4.0.0 
http://maven. apache. org/maven-v4_0_0.xsd" > 
<modelVersion >4.0.0 < /modelVersion > 
<groupId >com. juvenxu.mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId > 
<version >1.0.0-SNAPSHOT < /version > 

<packaging >pom < /packaging > 

<name >Account Parent < /name > 

<modules > 


<module >account—-email < /module > 


<module >account-persist < /module > 
< /modules > 
<properties > 
<springframework. version >2.5.6 < /springframework. version > 
<junit.version >4.7 </junit.version > 
< /properties > 
< dependencyManagement > 
< dependencies > 
< dependency > 
<groupid >org. springframework < /groupId > 
<artifactId>spring-core < /artifactIid> 
<version> $ ispringframework. version} < /version > 
< /dependency > 
< dependency > 
<groupid >org. springframework < /groupId > 
<artifactId >spring-beans < /artifactId > 
<version > $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<groupId >org. springframework < /groupId > 
<artifactId >spring-context < /artifactId> 
<version> $ {springframework, version} < /version > 
< /dependency > 
< dependency > 
<groupiId > org. springframework < /groupId > 
<artifactIid >spring-context-—support < /artifactId> 
<version> $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<groupid > junit < /groupid > 
<artifactId >junit < /artifactId> 
<version > $ (junit. version) < /version > 
<scope >test < /scope > 
< /dependency > 
< /dependencies > 
< /dependencyMenagement > 
<build> 
<pluginManagement > 
<plugins > 
<plugin> 
<groupId >org. apache. maven. plugins < /grouplId > 
<artifactId >maven-compiler-plugin < /artifactId> 
<configuration > 
<source >1.5 </source> 
<target >1.5</target > 
< /configuration > 
</plugin> 
<plugin > 
<groupId >org. apache. maven. plugins < /groupid > 
<artifactid >maven-resources-plugin < /artifactiId > 
<configuration > 
<encoding >UTF-8 < /encoding > 
< /configuration > 
< /plugin> 
< /plugins > 


/pluginManagement > 


在 代码 清单 8-21 中 可 以 看 到 ， 该 POM 的 打包 方式 为 pom， 它 包含 


一 个 modules 元 素 ， 表 示 用 来 聚合 account-persist 和 account-email 两 个 模 





块 ， 它 还 包含 了 properties、dependencyManagement 和 pluginManagement 
元 素 供 子 模块 继承 。 


相应 地 ，account-email 和 account-persist 的 POM 配 置 也 要 做 微小 的 修 
改 。 本 来 account-parent 和 它们 位 于 同 级 目录 ， 因 此 需要 使 用 值 
为 .Jaccount-parent/pom.xml 的 relativePath 元 素 。 现 在 新 的 account-parent 
在 上 一 层 目录 ， 这 是 Maven 默 认 能 识别 的 父 模块 位 置 ， 因 此 不 再 需要 配 
置 relativePath， 见 代码 清单 8-22。 














代码 清单 8-22 ” 当 父 模块 在 上 级 目录 时 不 再 需要 relativePath 


<parent > 
<groupid >com. juvenxu.mvnbook.account < /groupid > 
<artifactId >account-parent < /artifactId > 
<version >1.0.0-SNAPSHOT < /version > 


< / parent > 


<artifactId >account-email < /artifactId > 


<name >Account Email < /name > 


8.5 约定 优 于 配置 


标准 的 重要 性 已 不 用 过 多 强调 ， 想 象 一 下 ， 如 果 不 是 所 有 程序 员 都 
基于 HTTP 协 议 开 发 Web 应 用 ， 互 联网 会 乱 成 怎样 。 各 个 版 本 的 正 、 
Firefox 等 浏览 器 之 间 的 差别 已 经 让 很 多 开发 者 头痛 不 已 。 而 Java 成 功 的 
重要 原因 之 一 就 是 它 能 屏蔽 大 部 分 操作 系统 的 差异 ，XML 流 行 的 原因 
之 一 是 所 有 语言 都 接受 它 。Maven 当 然 还 不 能 和 这 些 既 成 功 又 成 熟 的 技 
术 相 比 ， 但 Maven 的 用 户 都 应 该 清楚 ，Maven 提 倡 “约定 优 于 配 


置 ”(Convention Over Configuration) ， 这 是 Maven 最 核心 的 设计 理念 之 














那么 为 什么 要 使 用 约定 而 不 是 自己 更 灵活 的 配置 呢 ? 原因 之 一 是 ， 
使 用 约定 可 以 大 量 减 少 配 置 。 先 看 一 个 简单 的 Ant 配 置 文件 ， 见 代码 清 
单 8-23。 


代码 清单 8-23 ”构建 简单 项 目 使 用 的 Ant 配 置 文件 


<description > 


ob eB © tio 


<property name = "dist" location="target"/ > 
<target name ="init"> 
— 41) 38 af fa) FH -> 
<tstamp/ > 
< 1 创建 编译 使 用 的 构建 目录 一 -> 
<mkdir dir =" $ {build}"/> 
< /target > 
target name = "cor pi e" depends ads oth Hh i 
dee iption = "compile the source " > 
<!-3} java 代码 从 目录 $ {src}) 编译 至 $ {build} =- 
< javac srcdir =" $ {src}" destdir =" $ {build}"/> 
target > 


"compile" 
"generate the distribution" 


<target name = "dist" depends 


description = 
< ! 一 创建 分 发 目录 一 -> 
<mkdir dir="5$ {dist}/lib"/> 
一 将 $ {build} g PTA 内 容 打 和 包 至 My i istic DSTAMP}.jar file ==> 
<jar jarfile="S$ {dist}/lib/MyProject-$ {DSTAMP}. jar" basedir =" $ {build} 
< / target > 
<target name = "clean" 
description ="clean up" > 
< 1 二 删除 S$ {build} 和 $ {dist} 目录 树 一 -> 
<delete dir =" $ {build}"/> 
<Gelete dir =" $ {dist}"/ > 
< /target > 
< /project > 


这 段 代码 做 的 事情 就 是 清除 构建 目录 、 创 建 目录 、 编 译 代码 、 复 制 
依赖 至 目标 目录 ， 最 后 打包 。 这 有 是 一 个 项 目 构建 要 完成 的 最 基本 的 事 
源码 目录 是 什么 、 编 译 目 
需要 记 住 各 种 Ant 任 务 

















不 过 为 此 还 是 需要 写 很 多 的 XML 配置 : 


情 ， 
分 发 目录 是 什么 》 人 用 户 还 


标 目录 是 什么 、 


命令 ， 如 delete、mkdir、javac 和 jar。 





做 同样 的 事情 ，Maven 需 要 什么 配置 呢 ? Maven 只 需 
的 POM， 见 代码 清单 8-24。 


代码 清单 8-24 构建 简单 项 目 使 用 的 Maven 配 置 文件 





这 段 配置 简单 得 令 人 惊奇 ， 但 为 了 获得 这 样 简 活 的 配置 ， 用 户 是 需 
要 付出 一 定 的 代价 的 ， 那 就 是 遵循 Maven 的 约定 。Maven 会 假设 用 户 的 
项 目 是 这 样 的 : 


:源码 目录 为 src/main/java/ 


编译 输出 目录 为 target/classes/ 





.打包 方式 为 jar 
' 包 输出 目录 为 target/ 
遵循 约定 虽然 损失 了 一 定 的 灵活 性 ， 用 户 不 能 随意 安排 目录 结构 ， 


但 是 却 能 减少 配置 。 更 重要 的 是 ， 遵 循 约定 能 够 帮助 用 户 遵守 构建 标 
准 。 

如 有 果 没 有 约定 ，10 个 项 目 可 能 使 用 10 种 不 同 的 项 目 目录 结构 ， 这 意 
味 着 交流 学 习 成 本 的 增加 ， 当 新 成 员 加 入 项 目的 时 候 ， 它 束 不 得 不 花 时 
间 去 学 习 这 种 构建 配置 。 而 有 了 Maven 的 约定 ， 大 家 都 知道 什么 目录 放 
什么 内 容 。 此 外 ， 与 Ant 的 目 定 义 目标 名 称 不 同 ，Maven 在 命令 行 暴露 
的 用 户 接口 是 统一 的 ， 像 mvn clean install 这 样 的 命令 可 以 用 来 构建 几乎 











任何 的 Maven 项 目 。 


也 许 这 时 候 有 读者 会 问 ， 如 果 我 不 想 遵 守 约 定 该 怎么 办 ? 这 时 ， 请 
首先 问 目 己 三 届 ， 你 真 的 需要 这 么 做 吗 ? 如 条 仅仅 是 因为 喜好 ， 就 不 要 
设 个 性 ， 个 性 往往 意味 着 牺牲 通用 性 ， 意 味 独 增加 无 谓 的 复杂 度 。 例 
如 ，Maven 人 允许 你 目 定义 源码 目录 ， 如 代码 清单 8-25 所 示 。 








代码 清单 8-25 “使 用 Maven 自 定义 源码 目录 


该 例 中 源码 目录 就 成 了 src/java 而 不 是 默认 的 src/main/java。 但 这 往 
往 会 造成 交流 问题 ， 习 惯 Maven 的 人 会 奇怪 ， 源 代码 去 哪里 了 ? 当 这 种 
自 定 义 大 量 存在 的 时 候 ， 交 流 成 本 就 会 大 大 提高 。 只 有 在 一 些 特殊 的 情 
况 下 ， 这 种 自 定 义 配 置 的 方式 才 应 该 被 正确 使 用 以 解决 实际 问题 。 例 如 
你 在 处 理 遗 留 代码 ， 并 且 没 有 办 法 更 改 原来 的 目录 结构 ， 这 个 时 候 就 只 


能 让 Maven 受 协 。 





本 书 兽 多 次 提 到 超级 POM， 任 何 一 个 Maven 项 目 都 隐 式 地 继承 自 该 
POM， 这 有 点 类 似 于 任何 一 个 Java 类 都 隐 式 地 继承 于 Object 类 。 因 此 ， 
大 量 超级 POM 的 配置 都 会 被 所 有 Maven 项 目 继承 ， 这 些 配置 也 就 成 为 了 


Maven 所 提倡 的 约定 。 


对 于 Maven 3， 超 级 POM 在 文件 $MAVEN_HOME/ib/maven- 
model-builder-x.x.x.jar+ HJ org/apache/maven/model/pom-4.0.0.xml E44 
下 。 对 于 Maven 2， 超 级 POM 在 文件 $ MAVEN HOME/lib/maven-x.x.x- 
uber.jar'# [Jorg/apache/maven/project/pom-4.0.0.xml H 3% Fo X Æ AYx.x.x 
表示 Maven 的 具体 版 本 。 


超级 POM 的 内 容 在 Maven 2 和 Maven 3 中 基本 一 致 ， 现 在 分 段 看 一 
下 ， 见 代码 清单 8-26。 


代码 清单 8-26 ”超级 POM 中 关于 仓库 的 定义 


<id>central </id> 
< name >Maven Repository Switchboard < /name > 
<url >http://repol.maven.org/maven2 < /url > 
< layout >default < /layout > 
<snapshots > 

< enabled > false < /enabled > 





<pluginRepositories > 
<pluginRepository > 
<id>central </id> 
<name >Maven Plugin Repository < /name > 
< Url >http://repol.maven.org/maven2 < furl > 


rout >default < /layout > 





<updatePolicy >never < /updatePolicy > 


< /releases > 






< /pluginRepos 
< /pluginRepositories > 


首先 超级 POM 定 义 了 仓库 及 插件 仓库 ， 两 者 的 地 址 都 为 中 央 仓 库 
http://repol.maven.org/maven2， 并 且 都 关闭 了 SNAPSHOT 的 支持 。 这 也 
就 解释 了 为 什么 Maven 默 认 残 可 以 按 需 要 从 中 央 仓 库 下 载 构件 。 


再 看 以 下 内 容 ， 见 代码 清单 8-27。 
代码 清单 8-27 超级 POM 中 关于 项 目 结构 的 定义 


<build> 
<directory > $ {project.basedir}/target </directory > 
<outputDirectory > $ {project. build. directory}/classes < /outputDirectory > 
<finalName > $ {project.artifactId}-S$ {project.version} < /finalName > 
<testOutputDirectory > $ {project.build.directory})/test-classes </testOut- 
putDirectory > 
<sourceDirectory > $ {project. basedir}/src/main/java < /sourceDirectory > 
<scriptSourceDirectory >src/main/scripts < /scriptSourceDirectory > 


<testSourceDirectory > $ {project.basedir}/srce/test/java < /testSourceDi- 


<directory > $ {(project.basedir}/src/main/resources < /directory > 


< /resources > 
<testResources > 


<testResource > 


<directory > $ (project. basedir}/src/test /resources < /directory > 


这 里 依次 定义 了 项 目的 主 输出 目录 、 主 代码 输出 目录 、 最 终 构 件 的 
名 称 格式 、 测 试 代码 输出 目录 、 主 源码 目录 、 脚 本 源码 目录 、 测 试 源码 
目录 、 主 资源 目录 和 测试 资源 目录 。 这 就 是 Maven 项 目 结构 的 约定 。 


紧 接着 超 级 POM 为 核心 插件 设 定 版 本 ， 见 代码 清单 8-28。 


代码 清单 8-28 ”超级 POM 中 关于 插件 版 本 的 定义 


<pluginManagement > 
<plugins > 
<plug in > 
<artifactid >maven-antrun-plugin < /artifactid> 
<version >1.3 < /version> 
< /plugin> 
<plugin> 


<artifactId >maven-assembly-plugin < /artifactiId > 


<artifactid >maven-clean-plugin < /artifactId> 


<plugin > 
<artifactId >maven-compiler-plugin < /artifactId > 
version >2.0.2</version > 
< /plugin > 


< /plugins > 
< /pluginManagement > 


< /build > 


由 于 篇 幅 原 因 ， 这 里 不 完整 罗列 ， 读 者 可 自己 找到 超级 POM 了 解 插 
件 的 具体 版 本 。Maven 设 定 核心 插件 的 原因 是 防止 由 于 插件 版 本 的 变化 
而 造成 构建 不 稳定 。 





超级 POM 的 最 后 是 关于 项 目 报告 输出 目录 的 配置 和 一 个 关于 项 目 发 
布 的 profile， 这 里 暂 不 深入 解释 。 后 面 会 有 相关 的 章节 讨论 这 两 项 配 
置 。 








可 以 看 到 ， 超 级 POM 实 际 上 很 简单 ， 但 从 这 个 POM 我 们 就 能 够 知 
晓 Maven 约 定 的 由 来 ， 不 仅 理 解 了 什么 是 约定 ， 为 什么 要 遵循 约定 ， 还 
能 明白 约定 是 如 何 实现 的 。 


8.6 XMH 


EPE BUR Maven hH H, RHE CReactor) 是 指 所 有 模块 组 
成 的 一 个 构建 结构 。 对 于 单 模 块 的 项 目 ， 反 应 堆 就 是 该 模块 本 身 ， 但 对 
于 多 模块 项 目 来 说 ， 有 反应 堆 就 包含 了 各 模块 之 间 继 承 与 依赖 的 关系， 从 
而 能 够 自动 计算 出 合理 的 模块 构建 顺序 。 





8.6.1 反应 扒 的 构建 顺序 


本 节 仍 然 以 账户 注册 服务 为 例 来 解释 反应 堆 。 首 先 ， 为 了 能 更 清楚 
地 解释 反应 堆 的 构建 顺序 ， 将 accountraggregator 的 聚合 配置 修改 如 下 : 





<modules > 
<module >account-email < /module > 
< mođule >account-persist < /module > 
<module >account-parent < /module > 
< /modules > 


修改 完毕 之 后 构建 account-aggregator 会 看 到 如 下 的 输出 : 
[INPO] “em ST ES RORE SE SS SS 


[INFO] Account Aggregator 
[INFO] Account Parent 
[INFO] Account Email 
[INFO] Account Persist 





述 输出 告诉 了 我 们 反应 堆 的 构建 顺序 ， 它 们 依次 为 account- 
aggregator、account-parent、accountremail 和 account-persist。 我 们 知道 ， 
如 果 按 顺序 读 取 POM 文 件 ， 前 先 应 该 读 到 的 是 account-aggregator 的 
POM， 实 际 情况 与 预料 的 一 致 ， 可 是 接 下 来 几 个 模块 的 构建 次 序 显然 与 
它们 在 聚合 模块 中 的 声明 顺序 不 一 致 ，account-parent 跑 到 了 account- 
email 亲 面 ， 这 是 为 什么 呢 ? 为 了 解释 这 一 现象 ， 先 看 图 8-4。 








account-aggregator 
account-email 
\ 


\ 
\ 


\ 
account-persist kd 


Neu IA 


、\ 


\\ 
account-parent 


图 8-4 ”账户 注册 服务 4 模块 的 反应 堆 








图 8-4 中 从 上 至 下 的 箭头 表示 POM 的 读 取 次 序 ， 但 这 不 足以 决定 反 
应 堆 的 构建 顺序 ，Maven 还 需要 考虑 模块 之 间 的 继承 和 依赖 关系 ， 图 中 
的 有 向 虚 连 接线 表示 模块 之 间 的 继承 或 者 依赖 《本 章 以 下 内 容 使 用 依赖 
泛 指 这 种 模块 间 的 依赖 或 继承 关系 ) ， 该 例 中 accountremail 和 account- 
persist 依 赖 于 account-parent， 那 么 account-parent 就 必须 先 于 另外 两 个 模 
块 构建 。 也 就 是 说 ， 这 里 还 有 一 个 从 右 向 左 的 箭头 。 实 际 的 构建 顺序 是 
这 样 形 成 的 ，Maven 按 序 读 取 POM， 如 果 该 POM 没 有 依赖 模块 ， 那 么 就 
构建 该 模块 ， 否 则 就 移 构建 其 依赖 模块 ， 如 果 该 依赖 还 依赖 于 其 他 模 
块 ， 则 进一步 先 构建 依赖 的 依赖 。 该 例 中 ，account-aggregator 没 有 依赖 
模块 ， 因 此 先 构 建 它 ， 接 着 到 account-email， 它 依赖 于 account-parent 模 
块 ， 必 须 先 构建 account-parent， 然 后 再 构建 account-email， 最 后 到 








account-persist 的 时 候 ， 由 于 其 依赖 模块 已 经 被 构建 ， 因 此 直接 构建 它 。 


模块 间 的 依赖 关系 会 将 反应 堆 构 成 一 个 有 问 非 循环 图 (Directed 
Acyclic Graph, DAG) ， 各 个 模块 是 该 图 的 节点 ， 依 赖 关 系 构成 了 有 回 
边 。 这 个 图 不 允许 出 现 循环 ， 因 此 ， 当 出 现 模块 A 依 赖 于 B， 而 B 又 依赖 
于 A 的 情况 时 ，Maven 就 会 报错 。 








8.6.2 BY Be DHE 


一 般 来 说 ， 用 户 会 选择 构建 整个 项 目 或 者 选择 构建 单个 模块 ， 但 有 
些 时 候 ， 用 户 会 想 要 仪 仅 构 建 完整 反应 堆 中 的 某 些 个 模块 。 换 句 话 说 ， 
用 户 需要 实时 地 裁剪 反应 堆 。 


Maven 提 供 很 多 的 命令 行 选项 支持 裁 蚤 反应堆， 输入 mvn-h 可 以 看 
到 这 些 选 项 : 


-am，--also-make 同 时 构建 所 列 模块 的 依赖 模块 


-amd-also-make-dependents 同 时 构建 依赖 于 所 列 模块 的 模块 





-pl，--projects<arg> 构 建 指 定 的 模块 ， 模 块 间 用 逗号 分 隔 
-If-resume-from<arg> 从 指定 的 模块 回复 反应 堆 


下 面 还 是 以 账户 服务 为 例 〈 为 合并 聚合 和 继承 ) ， 解 释 这 几 个 选项 
的 作用 。 默 认 情 况 从 account-aggregator 执 行 mvn clean install 会 得 到 如 下 
完整 的 反应 堆 : 


BO) = 
[INFO] Reactor Build Order: 
INFO] 


[INFO] Account Aggregator 

[INFO] Account Parent 

[INFO] Account Email 

[INFO] Account Persist 

[INFO] 

[INFO] 一 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 





S mvn clean install -pl account-email,account-persist 


得 到 的 反应 堆 为 : 


[INFO] -一 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 -一 一 一 -一 一 一 -一 一 一 -一 一 一 -一 一 
[INFO] Reactor Build Order: 

[INFO] 

[INFO] Account Email 

[INFO] Account Persist 

[INFO] 

[INFO] s a SAS nee ene 


使 用 -am 选项 可 以 同时 构建 所 列 模块 的 依赖 模块 。 例 如 : 


$ mvn clean install -pl account-email-am 


由 于 account-email 依 赖 于 account-parent， 因 此 会 得 到 如 下 反应 堆 : 


ES 
[INFO] Reactor Build Order: 
[INFO] 


[INFO] Account Parent 

[INFO] Account Email 

[INFO] 

[INFO] 一 一 -一 一 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


使 用 -amd 选 项 可 以 同时 构建 依赖 于 所 列 模块 的 模块 。 例 如 : 


$ mvn clean install -pl account-parent -amd 


由 于 account-email 和 account-persist 都 依赖 于 account-parent， 因 此 会 


得 到 如 下 反应 堆 : 





[INFO] :一 = 一 = 一 一 一 = 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 二 一 一 二 二 一 一 二 一 一 一 一 一 一 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Reactor Build Order: 
[INFO] 


[INFO] Account Parent 
[INFO] Acce 





[INFO] 





使 用 -rf 选项 可 以 在 完整 的 反应 堆 构 建 顺序 基础 上 指定 从 哪个 模块 开 
始 构建 。 例 如 : 


myn clean install -rf account-emai 





完整 的 反应 堆 构 建 顺序 中 ，account-email 位 于 第 三 ， 它 之 后 只 有 
account-persist， 因 此 会 得 到 如 下 的 裁 六 反应 堆 : 





[INFO] -一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 -一 一 一 -一 一 一 -一 一 
[INFO] Reactor Build Order: 

[INFO] 

[INFO] Account Email 

[INFO] Account Persist 

[INFO 

ee AA NAA IN ENEA ee pee ee eae 


最 后 ， 在 -pl-am 或 者 -pl-amd 的 基础 上 ， 还 能 应 用 -rf 参 数 ， 以 对 裁剪 
后 的 反应 堆 再 次 裁 甬 。 例 如 : 


$ mvn clean install -pl account-parent -amd -rf account-email 


该 命令 中 的 -p1 和 -amd 参 数 会 裁剪 出 一 个 account-parent、account- 
email 和 account-persist 的 反应 推 ， 在 此 基础 上 ，-rf 参 数 指 定 从 account- 
email 参 数 构建 。 因 此 会 得 到 如 下 的 反应 堆 : 





EN 
[INFO] Reactor Build Order: 
[INFO] 
[INFO] Account Email 
[INFO] Account Persist 
INFO 
[INFO] ~ 





在 开发 过 程 中 ， 有 灵活 应 用 上 述 4 个 参数 ， 可 以 帮助 我 们 跳 过 无 须 构 
建 的 模块 ， 从 而 加 速 构建 。 在 项 目 庞大 、 模 块 特别 多 的 时 候 ， 这 种 效果 


束 会 异常 明显 。 


87 wees 


本 章 介绍 并 实现 了 账户 注册 服务 的 第 二 个 模块 account-persist。 基 于 
这 一 模块 和 第 5 章 实现 的 account-email，Maven 的 聚合 特性 得 到 了 介绍 和 
使 用 ， 从 而 产生 了 account-aggregator 模 块 。 除 了 聚合 之 外 ， 继 承 也 是 多 
模块 项 目 不 可 不 用 的 特性 。account-parent 模 块 伴随 着 继承 的 概念 被 一 并 
引入 ， 有 了 继承 ， 项 目的 依赖 和 插件 配置 也 得 以 大 幅 优 化 。 





为 了 进一步 消除 读者 可 能 存在 的 混淆 ， 本 章 还 专门 将 聚合 与 继承 做 
了 详细 比较 。Maven 的 一 大 设计 理念 “约定 优 于 配置 "在 本 章 得 以 阐述 ， 
读者 甚至 可 以 了 解 到 这 个 概念 是 如 何 通 过 超级 POM 的 方式 实现 的 。 本 章 
最 后 介绍 了 多 模块 构建 的 反应 堆 ， 包 括 其 构建 的 顺序 ， 以 及 可 以 通过 怎 
样 的 方式 裁 勇 反应 堆 。 











第 9 半 ”使 用 Nexus 创 建 私服 


-Nexus 简介 

.安装 Nexus 
Nexus 的 仓库 与 仓库 组 
Nexus 的 索引 与 构件 搜索 
配置 Maven 从 Nexus 下 载 构件 
-部 署 构件 至 Nexus 
Nexus 的 权限 管理 
Nexus 的 调度 任务 
其 他 私服 软件 

:小结 


私服 不 是 Maven 的 核心 概念 ， 它 仅仅 是 一 种 衍生 出 来 的 特殊 的 
Maven 人 仓库， 本 书 已 经 在 6.3.4 节 解释 了 其 概念 和 用 途 ， 然 而 这 还 不 够 。 





WW BOAR, BRAT DRAM Oe ite. TAARN E DE 
Maven 构 建 、 目 己 部 署 构 件 等 ， 从 而 高 效 地 使 用 Maven。 





有 三 种 专门 的 Maven 仓 库 管 理 软件 可 以 用 来 帮助 大 家 建立 私服 : 
Apache 基 金 会 的 Archiva、JFrog 的 Artifactory 和 Sonatype 的 Nexus。 其 
中 ，Archiva 是 开源 的 ， 而 Artifactory 和 Nexus 的 核心 也 是 开源 的 ， 因 此 
读者 可 以 自由 选择 使 用 。 笔 者 作为 Nexus 开 发 团队 的 成 员 ， 自 然 十 分 推 


尝 Nexus。 事 实 上 ，Nexus 也 是 当前 最 流行 的 Maven 仓 库 管 理 软 件 。 


本 章 将 介绍 Nexus 的 主要 功能 ， 并 结合 大 量 图 片 帮 助 读者 快速 地 建 
立 起 自己 的 Maven 私 服 。 


9.1 Nexus 人 简介 





2005 年 12 月 ，Tamas Cservenak 由 于 受 不 了 匈牙利 电信 ADSL 的 低速 
度 ， 开 始 着 手 开 发 Proximity 一 一 一 个 很 简单 的 Web 应 用 。 它 可 以 代理 并 
缓存 Maven 构 件 ， 当 Maven 需 要 下 载 构件 的 时 候 ， 就 不 需要 反复 依赖 于 
ADSL。 到 2007 年 ，Sonatype 邀 请 Tamas 参 与 创建 一 个 更 酷 的 Maven 仓 库 
管理 软件 ， 这 就 是 后 来 的 Nexus。 





Nexus 团 队 的 成 员 来 目 世界 各 地 ， 它 也 从 社区 收 到 了 大 量 反 馈 和 大 
助 ， 在 写本 书 的 时 候 ，Nexus 刚 发 布 1.7.2 版 本 ， 它 也 正 健康 快速 地 成 长 
F o 


Nexus 分 为 开源 版 和 专业 版 ， 其 中 开源 版 本 基于 GPLv3 许 可 证 ， 其 
特性 足以 满足 大 部 分 Maven 用 户 的 需要 。 以 下 是 一 些 Nexus 开 源 版 本 的 


特性 : 
- 较 小 的 内 存 占 用 最少 仅 为 28MB) 
基于 ExtJS 的 友好 界面 
基于 Restlet 的 完全 REST API 


` 文 持 代 理 仓库 、 答 主 仓库 和 仓库 组 


基于 文件 系统 ， 不 需要 数据 库 
文 持仓 库 索 引 和 搜索 

支持 从 界面 上 传 Maven 构 件 

- 细 粒 度 的 安全 控制 


Nexus 专 业 版 本 是 需要 付费 购买 的 ， 除 了 开源 版 本 的 所 有 特性 之 
外 ， 它 主要 包含 一 些 企业 安全 控制 、 发 布 流 程控 制 等 需要 的 特性 。 感 兴 
趣 的 读者 可 以 访问 该 地 址 了 解 详 


情 : http://www.sonatype.com/products/nexus/community » 





9.2 ZÆ Nexus 


Nexus 是 典型 的 Java Web 应 用 ， 它 有 两 种 安装 包 ， 一 种 是 包含 Jetty 
容器 的 Bundle 包 ， 男 一 种 是 不 包含 Web 容 右 的 war 包 。 


9.2.1 下 载 Nexus 


首先 从 http://nexus.sonatype.org/downloads/ 下 载 最 新 版 本 的 Nexus， 
在 本 书 编写 的 时 候 ，Nexus 的 最 新 版 本 为 1.7.2。 读 者 可 以 根据 需要 下 载 
Bundle 包 nexus-webapp-1.7.2-bundle.tar.gz 和 nexus-webapp-1.7.2- 





bundle.zip， 或 者 war 包 nexus-webapp-1.7.2.war。 


9.2.2 Bundle 方 式 安 装 Nexus 


Nexus 的 Bundle 自 带 了 Jetty 容 器 ， 因 此 用 户 不 需要 额外 的 Web 容 器 
就 能 直接 启动 Nexus。 首 先 将 Bundle 文 件 解 压 〈( 例 如 笔者 将 其 解压 到 D: 
\bin\ 目 录 ) ， 这 时 融会 得 到 如 下 两 个 子 目录 : 








‘nexus-webapp-1.7.2/: 该 目录 包含 了 Nexus 运 行 所 需要 的 文件 ， 如 
局 动 脚本 、 依 赖 jar 包 等 。 


.Sonatype-work/: 该 目录 包含 Nexus 生 成 的 配置 文件 、 日 志文 件 、 仓 
库 文 件 等 。 


其 中 ， 第 一 个 目录 是 运行 Nexus 所 必需 的 ， 而 且 所 有 相同 版 本 Nexus 
实例 所 包含 的 该 目录 内 容 都 是 一 样 的 。 而 第 二 个 目录 不 是 必须 的 ， 
Nexus 会 在 运行 的 时 候 动态 创建 该 目录 ， 不 过 它 的 内 容 对 于 各 个 Nexus 实 
例 是 不 一 样 的 ， 因 为 不 同 用 户 在 不 同 机 器 上 使 用 的 Nexus 会 有 不 同 的 配 
置 和 仓库 内 容 。 当 用 户 需要 备份 Nexus 的 时 候 ， 默 认 备 份 sonatype-work/ 
目录 ， 因 为 该 目录 包含 了 用 户 特定 的 内 容 ， 而 nexus-webapp-1.7.2 目 录 下 
的 内 容 是 可 以 从 安装 包 直 接 获 得 的 。 








用 户 只 需要 调用 对 应 操作 系统 的 脚本 就 可 以 启动 Nexus， 这 里 介绍 
主流 的 在 Windows 和 Linux 平 台 上 启动 Nexus 的 方式 。 


在 Windows 操 作 系 统 上 ， 用 户 需 进入 nexus-webppp- 
1.7.2/bin/jsw/windows-x86-32/ 子 目录 ， 人 然后 直接 运行 nexus.bat 脚 本 就 能 
启动 Nexus。 如 果 看 到 如 下 输出 ， 束 说 明 启 动 成 功 了 : 


jvm 1 | 2010-09-02 15:27:11 INFO [fer_start_runner] -o0.s.n.DefaultNexus - 
Started Nexus (version 1.7.2 OSS) 
jvm 1 |2010-09-02 15:27:11 INFO [er _start_runner] -0.s.n.p.a.DefaultAt ~ 


-Attribute storage directory does not exists, creating it here 

:. \.. \sonatype-work \nexus \proxy \attributes 

jvm 1 | 2010-09-02 15:27:11 WARN [er_start_runner] -o0.s.s.m.s.FileModel ~ - 
No configuration file in place, copying the default one andc 

ontinuing with it. 

jvm i |}2010-09-02 15:27:11 INFO [er_start_runner] -o0.s.s.m.s.FileModel ~ - 
Loading Security configuration from D: \bin \nexus-oss-webapp-1 

.7.2\. \.. \sonatype-work \nexus \conf \security. xml 

jvm 1 |} 2010-09-02 15:27:11 INFO [er_start_runner] -o.s.s.w.PlexusConfi ~ - 
SecurityManager with role ="org. sonatype. security. PlexusSecuri 

tyManager’and roleHint ='web'found in Plexus. 

jvm 1 | 2010-09-02 15:27:12 INFO [er_start_runner) -org.mortbay. log -Star- 
ted SelectChannelConnector@ 0.0.0.0:8081 


这 时 ， 打 开 浏 览 器 访问 http://localhost: 8081/nexus/ 就 能 看 到 Nexus 
的 界面 ， 如 图 9-1 所 示 。 








== Sonatype Nexus Mave... =e 





€ © y http://localhost:8081/nexus/index.htmi#welcome > Or fF 
-一 一 - Log In 
— O N aty ao Sonatype Nexus™ Open Source Edition, Version: 1.7.2 
Sonatype™ Servers a 
Nexus 
Artifact Search 全 oo 
一 全- 一- 
a == Nexus 
一 : 一 -: 
Advanced Search 
Views/ Repositories a Type in the name of a project, dass, or artifact into the text box below, 
Ri and dick Search. Use "Advanced Search" on the left for more options. 
positories 
Help a £ 








图 9-1 ” Nexus 的 初始 界面 
要 停止 Nexus， 可 以 在 命令 行 按 Ctrl+C 键 。 


在 nexus-webppp-1.7.2/bin/jsw/windows-x86-32/ 目 录 下 还 有 其 他 一 些 
脚本 : 


:Installnexus.bat: 将 Nexus 安 装 成 Windows 服 务 。 
.Uninstallnexus.bat: ##¢Nexus Windows 服 务 。 


-Startnexus.bat: 启动 Nexus Windows 服 务 。 


.Stopnexus.bat: 停止 Nexus Windows 服 务 。 
-Pausenexus.bat: 暂停 Nexus Windows 服 务 。 
-Resumenexus.bat: 恢复 暂停 的 Nexus Windows 服 务 。 


借助 Windows 服 务 ， 用 户 束 可 以 让 Nexus 伴 随 着 Windows 目 动 局 
动 ， 非 常 方便 。 


在 Linux 系 统 上 局 动 Nexus 也 非常 方便 ， 例 如 笔者 使 用 Ubuntu 32 位 系 
统 ， 那 么 只 需要 进入 到 nexus-webapp-1.7.2/bin/jsw/linux-x86-32/， 然 后 运 


行 如 下 命令 : 


$ . Mexus console 


同样 地 ， 读 者 可 以 看 到 Nexus 启 动 的 命令 行 输出 ， 并 且 可 以 使 用 
Ctrlt+C 键 停止 Nexus。 除 了 console 之 外 ，Nexus 的 Linux 脚 本 还 提供 如 下 
的 命令 : 


-/nexus start: 在 后 台 局 动 Nexus 服 务 。 
-/nexus stop: 停止 后 台 的 Nexus 服 务 。 
-/nexus status: 查看 后 台 Nexus 服 务 的 状态 。 


`./nexus restart: 重新 局 动 后 人 台 的 Nexus 服 务 。 


关于 Bundle 安 装 的 一 个 利 见 问题 是 问 口 冲突 。Nexus Bundle 默 认 使 
用 的 端口 是 8081， 如 有 果 该 端口 已 经 被 其 他 应 用 程序 占用 ， 或 者 你 想 使 用 
80 端 口 开 放 Nexus 服 务 ， 则 编辑 文件 nexus-webapp- 
1.7.2/conf/plexus.properties， 找 到 属性 application-port， 按 需要 将 默认 值 
8081 改 成 其 他 端口 号， 然后 保存 该 文件 ， 重 局 Nexus 便 可 。 


9.2.3 ”WAR 方式 安装 Nexus 


除了 Bundle，Nexus 还 提供 一 个 可 以 直接 部 普 到 Web 容 器 中 的 war 
包 。 该 war 包 支持 主流 的 Web 容 器 ， 如 Tomcat、Glassfish、Jetty 和 和 


Resin。 


以 Tomcat 6 为 例 ， 笔 者 在 Vista 机 器 上 的 目录 为 D: \bin\apache- 
tomcat-6.0.20\， 那 么 只 需要 复制 Nexus war 包 至 Tomcat 的 部 署 目录 D: 
\binvapache-tomcat-6.0.20\webapps\nexus.war， 然 后 转 到 D: \bin\apache- 
tomcat-6.0.20\bin\ 目 录 ， 运 行 startup.bat。 这 时 ， 读 者 可 以 从 Tomcat 的 
console 输 出 中 看 到 它 部 署 nexus.war。 


待 Tomcat 启 动 完 成 后 ， 访 问 http://localhost: 8080mexus/ 就 能 看 到 
Nexus 的 界面 了 。 


9.2.4 登录 Nexuas 


Nexus 拥 有 全 面 的 权限 控制 功能 ， 默 认 的 Nexus 访 问 都 是 匿名 的 ， 而 
匿名 用 户 仅 包 含 一些 最 基本 的 权限 ， 要 全 面 学 习 和 管理 Nexus， 就 必须 
以 管理 员 方式 登录 。 可 以 单 击 界面 右上 角 的 Log In 进行 登录 ，Nexus 的 
默认 管理 员 用 户 名 和 密码 为 admin/admin123， 如 图 9-2 所 示 。 





= Sonatype 


Sonatype™ Servers Welcome 
Nexus 


Artifact Scarch 


___- == Nlexys 


Views /Repositones 全 Username: admin tinto the text box below 
2 left for more options. 


Password: 








图 9-2 ”使 用 默认 用 户 名 登录 Nexus 


9.3 ”Nexus 的 仓库 与 仓库 组 


作为 Maven 仓 库 服务 软件 ， 仓 库 目 然 是 Nexus 中 最 重要 的 概念 。 
Nexus 包 侣 了 各 种 类 型 的 仓库 概念 ， 包 括 代理 仓库 、 和 宿主 仓库 和 仓库 组 
等 。 每 一 种 仓库 都 提供 了 丰富 实用 的 配置 参数 ， 方 便 用 户 根据 需要 进行 


定制 。 





9.3.1 Nexus 内 置 的 仓库 


在 具体 介绍 每 一 种 类 型 的 仓库 之 前 ， 先 浏览 一 下 Nexus 内 置 的 一 些 
仓库 。 单 击 Nexus 界 面 左边 导航 栏 中 的 Repositories 链 接 ， 束 能 在 界面 右 
边 看 到 如 图 9-3 所 示 的 内 容 。 





这 个 列表 已 经 包含 了 所 有 类 型 的 Nexus 仓 库 。 从 中 可 以 看 到 仓库 有 
四 种 类 型 : group 〈 仓 库 组 ) . hosted GEE) ~ proxy (代理) 和 
virtual〈 虚 拟 ) 。 每 个 仓库 的 格式 为 maven2 或 者 maven1。 此 外 ， 仓 库 还 
有 一 个 属性 为 Policy〔〈 和 策略) ， 表 示 该 仓库 为 发 布 (Release) 版 本 仓库 
还 是 快照 (Snapshot) 版 本 仓库 。 最 后 两 列 的 值 为 仓库 的 状态 和 路 径 。 





下 面 解释 一 下 各 个 仓库 的 用 途 。 由 于 本 书 不 涉及 Maven 1 的 内 容 ， 
mavenl 格 式 的 仓库 会 被 省 略 。 此 外 ， 由 于 虚拟 类 型 仓库 的 作用 实际 上 是 
动态 地 将 仓库 内 容 格 式 转换 ， 换 言 之 也 是 为 了 服务 mavenl 格 式 ， 因 此 也 
被 省 略 。 


Repository « Type Format i Repository S Repository Path 

Public Repositories group maven2 http//ocalhost:808 1/nexus/content/groups/public 

Public Snapshot Repositories group maven2 tittpv//localhost:8081/nexus/content/groups/public-snapshots 

3rd party hosted maven2 Release In Service http://ocalhost:8081/nexus/content/repositories/thirdparty 

Apache Snapshots proxy mayen2 Snapshot In Service http-/ocalhost:8081/nexus/content/repositories/apache-snapshot: 
Central M1 shadow virtual mavent Release In Service http:/Aocalhost:8081/nexus/content/shadows/centrat-m1 
Codehaus Snapshots proxy maven2 Snapshot in Service http://ocalhost:8081/nexus/content/repositories/codehaus-snapsh 
Google Code proxy maven2 Release In Service http:/Mocalhost:8031/nexus/content/repositories/google 

java.net - Maven 2 proxy maven2 Release In Service http-/Mocalhost:3081/nexus/content/repositories/java..net-m2 


java.net-m1 proxy mavent Release In Service http://localhost:3081/nexus/content/repositories/java.net-m1 


java.net-m1 M2 shadow virtual maven2 Release In Service hittp:/ocalhost8081 /nexus/content/shadow s/java_net-m1-m2 


Maven Central proxy maven2 Release in Service http-/Mocalhost:8081/nexus/content/repositories/central 
Releases hosted maven2 Release In Service http:/ocalhost:8081/nexus/content/repositories/releases 


Snapshots hosted maven2 Snapshot iIn Service http://localhost:8081/nexus/content/reposittories/snapshots 


图 9-3” Nexus 内 置 的 仓库 列表 





-Maven Central: 该 仓库 代理 Maven 中 央 人 仓库， 其 策略 为 Release， 
上 只 会 下 载 和 缓存 中 央 仓 库 中 的 发 布 版 本 构件 。 


‘Releases: 这 是 一 个 策略 为 Release 的 宿主 类 型 仓库 ， 用 来 部 署 组 织 
内 部 的 发 布 版 本 构件 。 


‘Snapshots: 这 是 一 个 策略 为 Snapshot 的 宿主 类 型 仓库 ， 用 来 部 署 组 
织 内 部 的 快照 版 本 构件 。 


-3rd party: 这 是 一 个 策略 为 Release 的 宿主 类 型 仓库 ， 用 来 部 署 无 法 
从 公共 仓库 获得 的 第 三 方 发 布 版 本 构件 。 





‘Apache Snapshots: 这 是 一 个 策略 为 Snapshot 的 代理 仓库 ， 用 来 代 
理 Apache Maven 仓 库 的 快照 版 本 构件 。 


‘Codehaus Snapshots: 这 是 一 个 策略 为 Snapshot 的 代理 仓库 ， 用 来 


代理 Codehaus Maven 仓 库 的 快照 版 本 构件 。 


-Google Code: 这 是 一 个 策略 为 Release 的 代理 仓库 ， 用 来 代理 
Google Code Maven 仓 库 的 发 布 版 本 构件 。 





-java.net-Maven 2: 这 是 一 个 策略 为 Release 的 代理 仓库 ， 用 来 代理 
java.net Maven 仓 库 的 发 布 版 本 构件 。 





"Public Repositories: 该 仓库 组 将 上 述 所 有 策略 为 Release 的 仓库 聚 
合并 通过 一 致 的 地 址 提供 服务 。 


-Public Snapshot Repositories: 该 仓库 组 将 上 述 所 有 策略 为 Snapshot 
的 仓库 聚合 并 通过 一 致 的 地 址 提供 服务 。 


举 一 个 简单 的 例子 。 假 设 某 公司 建立 了 Maven 项 目 X， 公 司 内 部 建 
并 了 Nexus 私 服 ， 为 所 有 Maven 项 目 提供 服务 。 项 目 X 依 赖 于 很 多 流行 的 
开源 类 库 如 JUnit 等 ， 这 些 构件 都 能 从 Maven 中 央 仓库 获得 ， 因 此 Maven 
Central 代 理 仓库 会 被 用 来 代理 中 央 仓库 的 内 容 ， 并 在 私服 上 缓存 下 来 ， 
X 还 依赖 于 某 个 Google Code 的 项 目 ， 其 构件 在 中 央 仓 库 中 不 存在 ， 只 存 
在 于 Google Code 的 仓库 中 ， 因 此 上 述 列表 中 的 Google Code 代 理 仓库 会 
被 用 来 代理 并 缓存 这 样 的 构件 。X 还 依赖 于 Oracle 的 JDBC 驱 动 ， 由 于 版 
权 的 因素 ， 该 类 库 无 法 从 公共 仓库 获得 ， 因 此 公司 管理 员 将 其 部 署 到 
3rd party 宿 主 仓库 中 ， 供 X 使 用 。X 的 快照 版 本 构件 成 功 后 ， 会 被 部 署 到 
Snapshots 宿 主 仓库 中 ， 供 其 他 项 目 使 用 。 当 X 发 布 正式 版 本 的 时 候 ， 其 














构件 会 被 部 署 到 Release 符 主 仓 库 中 。 由 于 X 用 到 了 上 述 列表 中 的 很 多 仓 
库 ， 为 每 个 仓库 声明 Maven 配 置 义 比较 抹 烦 ， 因 此 可 以 直接 使 用 仓库 组 
Public Repositories 和 Public Snapshot Repositories， 当 XX 需要 JUnit 的 时 





候 ， 它 直接 从 Public Repositories F #¥%, Public Repositories 会 选择 Maven 


Central 提 供 实际 的 内 容 。 


9.3.2 Nexus 仓库 分 类 的 概念 


为 了 帮助 读者 理解 箱 主 仓库 、 代 理 仓 库 和 仓库 组 的 概念 ， 图 9-4 用 
更 为 直观 的 方式 展现 了 它们 的 用 途 和 区 别 。 


代理 仓库 A 


代理 仓库 B 


图 9-4 各 种 类 型 的 Nexus 仓 库 








从 图 9-4 中 可 以 看 到 ，Maven 可 以 直接 从 宿主 仓库 下 载 构件 ，Maven 
也 可 以 从 代理 仓库 下 载 构件 ， 而 代理 仓库 会 间接 地 从 远程 仓库 下 载 并 组 
存 构件 ， 最 后 ， 为 了 方便 ，Maven 可 以 从 仓库 组 下 载 构件 ， 而 仓库 组 没 
有 实际 内 容 《〈《 图 中 用 虚线 表示 ) ， 它 会 转向 其 包含 的 宿主 仓库 或 者 代理 
仓库 获得 实际 构件 的 内 容 。 





9.3.3 ”创建 Nexus 答 主 仓库 





要 创建 一 个 宿主 仓库 ， 首 先 单 击 界面 左边 导航 栏 中 的 Repositories 链 
接 ， 在 右边 的 面板 中 ， 选 择 Add， 接 着 在 下 拉 菜 单 中 选择 Hosted 
Repository， 就 会 看 到 图 9-5 所 示 的 配置 界面 。 





New Hosted Repository 

Repository ID 

Repository Name 

Repository Type t 


Provider Maven2 Repository 


Format te 
Repository Policy Release ~ 
Default Local Storage Location 
Override Local Storage Location 

a Access Settings 


Deployment Policy Disable Redeploy Y & 
Alow File Browsing True ~x g 
Indude in Search True y 


Publish URL True M 


a Expiration Settings 


Not Found Cache TTL minutes & 





图 9-5 ”创建 Nexus 宿 主 仓库 








根据 自己 的 需要 填 入 仓库 的 ID 和 名 称 ， 下 一 字段 Repository Type 表 
示 该 仓库 的 类 型 。Provider 用 来 确定 该 仓库 的 格式 。 一 般 来 说 ， 选 择 默 
认 的 Maven2 Repository。 然 后 是 Repository Policy， 读 者 可 以 根据 自己 的 
需要 来 配置 该 仓库 是 发 布 版 构件 仓库 还 是 快照 版 构件 仓库 。Default 
Local Storage Location 表 示 该 仓库 的 默认 存储 目录 ， 图 中 该 字段 的 值 为 
空 ， 待 仓库 创建 好 之 后 ， 该 值 束 会 成 为 基于 sonatype-work 的 一 个 文件 路 
径 ， 如 sonatype-work/nexus/storage/repository-id/，Override Local Storage 


Location 可 以 用 来 配置 自 定 义 的 仓库 目录 位 置 。 

















在 Access Settings 小 组 中 ，Deployment Policy 用 来 配置 该 仓库 的 部 署 
策略 ， 选 项 有 只 读 《〈 禁 止 部 署 ) 、 关 闭 重新 部 署 〈 同 一 构件 只 能 部 署 一 
次 ) 以 及 允许 重新 部 署 。Allow File Browsing 表 示 是 否 允 许 浏览 仓库 内 
容 ， 一 般 选 True。 每 个 仓库 〈 包 括 代理 仓库 和 仓库 组 ) 都 有 一 个 Browse 
Storage 选 项 卡 ， 用 户 以 树 形 结构 浏览 仓库 存储 文件 的 内 容 ， 如 图 9-6 所 
示 。Include in Search 表 示 是 否 对 该 仓库 进行 索引 并 提供 搜索 ， 我 们 会 在 
9.4 节 详细 讨论 索引 和 搜索 。Publish URL 用 来 控制 是 否 通 过 URL 提 供 服 
务 ， 如 果 选 False， 当 访问 该 仓库 的 地 址 时 ， 会 得 到 HTTP 404 Not Found 
错误 。 配 置 中 最 后 的 Not Found Cache TTL 表 示 当 一 个 文件 没有 找到 后 ， 
缓存 这 一 不 存在 信息 的 时 间 。 以 默认 值 1440 分 钟 为 例 ， 如 果 某 文件 不 存 
在 ， 那 么 在 之 后 的 1440 分 钟 内 ， 如 果 Nexus 再 次 得 到 该 文件 的 请 求 ， 它 
将 直接 返回 不 存在 信息 ， 而 不 会 查找 文件 系统 。 这 么 做 是 为 了 避免 重复 
的 文件 查找 操作 以 提升 性 能 。 





Browse Storage | Browse Index 


= Refresh Path Lookup: 


3J Releases 
a (index 
a ].meta 
B br 
®II com 
# (jit 
a |__) javax 
(3 junit 
alunit 
(3.7 
333.8 
=) junit-3.8 jar 
= junit-3.8 jar.md5 
= junit-3.8 jar.shat 
=] junit-3.8.pom 
=] junit-3.8.pom.md5 
=] Junit-3.8.pom,sha1 
 {}3.8.1 
a (3.8.2 








图 9-6 ”浏览 Nexus 仓 库 内 容 


9.3.4 创建 Nexus 代 理 仓库 





首先 单 击 界面 左边 导航 栏 中 的 Repositories 链 接 ， 在 右边 的 面板 中 ， 
选择 Add...， 接 着 在 下 拉 衣 单 中 选择 Proxy Repository， 束 会 看 到 图 9-7 所 
示 的 配置 界面 。 








仓库 的 ID、 名 称 、Provider、Format、Policy、 默 认 本 地 存储 位 置 和 
履 善 本 地 存储 位 置 等 配置 前 面 都 已 提 过 ， 这 里 不 再 痪 述 。 需 要 注意 的 
是 ， 这 里 的 Repository Type 的 值 为 proxy。 





对 于 代理 仓库 来 说 ， 最 重要 的 是 远程 仓库 的 地 址 ， 即 Remote 
Storage Location， 用 户 必 须 在 这 里 输入 有 效 的 值 。Download Remote 
Indexes 表 示 是 否 下 载 远 程 仓库 的 索引 ， 有 些 远程 仓库 拥有 索引 ， 下 载 其 
索引 后 ， 即 使 没有 绥 存 远程 仓库 的 构件 ， 用 户 还 是 能 够 在 本 地 搜索 和 浏 
览 那些 构件 的 基本 信息 。Checksum Policy 配 置 校 验 和 出 错时 的 策略 ， 用 
户 可 以 选择 忽略 、 记 录 和 警告 信息 或 者 拒绝 下 载 。 当 远程 仓库 需要 认证 的 
时 候 ， 这 里 的 Authentication 配 置 就 能 派 上 用 处 。 

















New Proxy Repository 

Repository ID 

Repository Name 

Repository Type w 
Provider Maven2 Repository 
Format 42! 
Repository Policy Release Y $ 
Default Local Storage Location 


Override Local Storage Location 


+ Remote Repository Access 


Remote Storage Location http://some-remote-repository/repo-root 


Download Remote Indexes True | es 


Checksum Policy Warn xa 
[E] Authentication (optional) 


+ | Access Settings 


a Expiration Settings 
Not Found Cache TTL minutes &) 
Artifact Max Age 2 minutes & 
Metadata Max Age minutes & 


|| HTTP Request Settings (optional) 


|| Override HTTP Proxy Settings (optional) 








图 9-7 创建 Nexus 代 理 仓库 


Access Settings IAC SA ECA, FEIN oa. Expiration 
Settings 较 宿主 仓库 多 了 Artifact Max Age 和 Metadata Max Age. HF, Hil 
者 表示 构件 缓存 的 最 长 时 间 ， 后 者 表示 仓库 元 数据 文件 缓存 的 最 长 时 











间 。 对 于 发 布 版 仓库 来 说 ，Artifact Max Age 默 认 值 为 -1， 表 示 构 件 缓存 
后 就 一 直 保 存 着 ， 不 再 重新 下 载 。 对 于 快照 版 仓库 来 说 ，Artifact Max 
Age 默 认 值 为 1440 分 钟 ， 表 示 每 隔 一 天 重新 缓存 代理 的 构件 。 








配置 中 最 后 两 项 为 HTTP Request Settings 和 Override HTTP Proxy 
Settings， 其 中 前 者 用 来 配置 Nexus 访 问 远程 仓库 时 HTTP 请 求 的 参数 ， 


后 者 用 来 配置 HTTP 代 理 。 


9.3.5 ”创建 Nexus 仓 库 组 





要 创建 一 个 仓库 组 ， 首 先 单 击 界面 左边 导航 栏 中 的 Repositories 链 
接 ， 在 右边 的 面板 中 ， 选 择 Add， 接 着 在 下 拉 菜 单 中 选择 Repository 
Group， 就 会 看 到 图 9-8 所 示 的 配置 界面 。 








配置 中 的 ID、Name 等 信息 这 里 不 再 痪 述 。 需 要 注意 的 是 ， 仓 库 组 
没有 Release 和 Snapshot 的 区 别 ， 这 不 同 于 答 主 仓库 和 代理 仓库 。 在 配置 
界面 中 ， 用 户 可 以 非常 直观 地 选择 Nexus 中 仓库 ， 将 其 聚合 成 一 个 虚拟 
的 仓库 组 。 注 意 ， 仓 库 组 所 包含 的 仓库 的 顺序 决定 了 仓库 组 志 历 其 所 含 
仓库 的 次 序 ， 因 此 最 好 将 常用 的 仓库 放 在 前 面 ， 当 用 户 从 仓库 组 下 载 构 
件 的 时 候 ， 就 能 够 尽快 地 访问 到 包含 构件 的 仓库 。 
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图 9-8 创建 Nexus 仓 库 组 


9.4 ” Nexus 的 索引 与 构件 搜索 


既然 Nexus 能 够 维护 和合 主 仓库 并 代理 缓存 远程 仓库 〈 如 Maven 中 央 
库 ) ， 那 么 一 个 简单 的 需求 就 自然 浮现 出 来 了 ， 这 就 是 搜索 。Maven 中 
央 库 有 几 十 万 构件 供用 户 使 用 ， 但 有 时 我 们 往往 仅仅 知道 茶 个 关键 字 ， 
如 Ehcache， 而 不 知道 其 确切 的 Maven 坐 标 。Nexus 通 过 维护 仓库 的 索引 
来 提供 搜索 功能 ， 能 在 很 大 程度 上 方便 Maven 用 户 定位 构件 坐标 。 





6.8.1 市 介绍 了 Sonatype 提 供 的 在 线 免 费 搜索 服务 ， 其 实用 户 可 以 很 
方便 地 自己 维护 一 个 Nexus 实 例 ， 并 提供 搜索 服务 。 


为 了 能 够 搜索 Maven 中 央 库 ， 首 先 需要 设置 Nexus 中 的 Maven 
Central 代 理 仓库 下 载 远 程 索 引 ， 如 图 9-9 所 示 。 需 要 注意 的 是 ， 默 认 这 
个 配置 的 值 是 关闭 的 。 此 外 ， 由 于 中 央 库 的 内 容 比 较 多 ， 因 此 其 索引 文 
件 比 较 大 ，Nexus 下 载 该 文件 也 需要 比较 长 的 时 间 ， 读 者 还 需要 耐心 等 
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可 以 想象 到 ，Nexus 在 后 全 运行 了 一 个 任务 来 下 载 中 央 仓 库 的 索 
引 ， 幸 运 的 是 ， 用 户 可 以 通过 界面 直接 观察 这 一 任务 的 状态 。 单 击 界面 
左边 导航 栏 中 的 Scheduled Tasks 链 接 后 ， 用 户 就 能 在 界面 的 右边 看 到 系 
统 的 调度 任务 ， 如 果 Nexus 下 在 下 载 中 央 仓 库 的 索引 ， 用 户 就 能 看 到 图 
9-10 所 示 的 一 个 任务 ， 其 状态 为 RUNNING。 在 索引 下 载 完毕 之 后 ， 该 
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有 了 索引 ， 用 户 即 可 搜索 Maven 构 件 了 。Nexus 界 面 左边 导航 栏 有 
一 个 快捷 搜索 框 ， 在 其 中 输入 关键 字 后 ， 单 击 搜索 按钮 就 能 快速 得 到 搜 
索 结果 ， 如 图 9-11 所 示 。 
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图 9-9 ”为 Maven Central 仓 库 开 启 远 程 索引 下 载 


Scheduled Tasks 


= Refresh (J Add @ Delete 


Enabled Name « Type Status Schedule 
true Remote URL Changed. Reindex Repositories RUNNING internal 





图 9-10 “下载 Maven 中 央 仓 库 索 引 的 后 台 任 务 








Sonatype™ Servers «i | Welcome Search z 
Keyword Search + | ehcache P 
Group Artifact Version Download 
leiate ehcache ehcache Latest 1.2.3 (Show All Versions) pom 
Pana Search net.sfehcache ehcache Latest: 2.2.0 (Show All Versions) pom 
org.dspace.xmlui.ehcache ehcache Latest 1.1 (Show All Versions) pom, jar 
Views/Repositories 2 net stehcache ehcache-site Latest 1.4.0 (Show All Versions) pom, jar 
Repositories net.sf.ehcache ehcache-web-parent Latest 2.0.2 (Show All Versions) pom 
Help 一 net.sf.ehcache ehcache-distribution Latest 1.3.0-beta2 (Show All Versions) pom, srczip, bin zip 
netsfehcache ehcache-explicitlocking Latest 0.2 (Show All Versions) pom, jar, javadocjar, sources jar 
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图 9-11 在 Nexus 中 快速 搜索 构件 





该 例 使 用 了 ehcache 关 键 字 进行 搜索 ， 因 此 得 到 了 大 量 与 ehcache 相 
关 的 结果 ， 结 果 中 的 每 一 行 都 表示 了 一 类 构件 ， 信 息 包括 GroupId、 
ArtifactId、 最 新 版 本 以 及 最 新 版 本 的 相关 文件 下 载 等 。 单 击 其 中 的 某 一 
行 ， 界面 的 下 端 会 浮 出 一 个 更 具体 的 构件 信息 面板 ， 如 图 9-12 所 示 。 














Viewing Repository: Central Proxy Maven Information Artifact Information 
a C 1.6.0-rc1 
# J 1.6.0-snapshot 
各 六 16.1 Artifact: ehcache 
a g1 6 2 Version: 2.2.0 
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a171 , XML: <dependency> 

<groupld >net.sf.ehcache</oroupld> 


: Group: net.sf.ehcache 


Extension: pom 


H (9g 1.7.2 


; <artifactId>ehcache</artifactId> 
ag 1.8.0 <version>2.2.0</version> 
B (2.0.0 <type>pom</type> 


a 20.1 </dependency> 
H (gg 2.1.0 
H (gg 21.1 
Sg 2.2.0 
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图 9-12 Nexus 的 构件 信息 面板 


该 面板 除了 显示 构件 的 坐标 ， 还 包含 了 一 段 XML 依赖 声明 ， 用 户 
可 以 直接 复制 粘贴 到 项 目的 POM 中 。 此 外 ， 用 户 还 能 从 该 面板 获知 构件 
在 仓库 中 的 相对 位 置 。 单 击 Artifact Information 还 能 看 到 文件 具体 的 大 
小 、 更 新 时 间 、SHA1 和 MD5 校 验 和 以 及 下 载 链 接 。 除 了 简单 的 关键 字 
搜索 ，Nexus 还 提供 了 GAV 搜 索 、 类 名 搜索 和 校 验 和 搜索 等 功能 ， 用 户 
可 以 单 击 搜索 页 面 左上 角 的 下 拉 沫 单 选择 高 级 搜索 功能 : 


-GAV 搜 索 (GAYV Search) 允许 用 户 通过 设置 GroupId、ArtifactId 和 
Version 等 信息 来 进行 更 有 针对 性 的 搜索 。 





.类 名 搜索 (Classname Search) 允许 用 户 搜索 包含 某 个 Java 类 的 构 
件 。 


. 校 验 和 搜索 (Checksum Search) 允许 用 户 直 接 使 用 构件 的 校 验 和 
来 搜索 该 构件 。 


图 9-11 所 示 的 结果 中 包含 了 各 种 坐标 的 结果 。 基 于 该 结果 的 信息 ， 
笔者 进一步 确定 了 自己 需要 的 构件 的 GroupId 和 Artifacttd， 它 们 分 别 为 
net.sf.ehcache 和 ehcache。 这 时 就 可 以 单 击 对 应 的 Show All Versions 转 到 
GAV 搜 索 功 能 来 缩小 搜索 范围 ， 如 图 9-13 所 示 。 
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Displaying Top 36 records * Clear Results 


图 9-13 ”在 Nexus 中 使 用 GAV 搜 索 构 件 


当然 ， 用 户 也 可 以 自己 手动 输入 GroupId、ArtifactId 等 信息 来 进行 
GAV 搜 索 。 


有 了 中 央 仓 库 的 索引 ， 用 户 不 仅 能 够 搜索 构件 ， 还 能 够 直接 浏览 
央 仓 库 的 内 容 。 这 便 是 Nexus 的 索引 浏览 功能 。 在 Repositories 页 面 中 ， 
选择 Browse Index 选 项 卡 ， 就 能 看 到 中 央 仓 库 内 容 的 树 形 结构 ， 如 图 9- 
14 所 未。 
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图 9-14 Nexus 的 索引 浏览 


以 上 的 搜索 及 浏览 功能 都 是 基于 Nexus 索 引 而 实现 的 ， 确 切 地 应 该 
称 之 为 nexus-indexer。Nexus 能 够 表 历 一 个 Maven 仓 库 所 有 的 内 容 ， 搜 集 
它们 的 坐标 、 校 验 和 及 所 含 的 Java 类 信息 ， 然 后 以 nexus-indexer 的 形式 
保存 起 来 。 中 央 仓 库 维 护 了 这 样 的 一 个 nexus-indexer， 因 此 本 地 的 
Nexus 下 载 到 这 个 索引 之 后 ， 就 能 在 此 基础 上 提供 搜索 和 浏览 等 服务 。 
再 要 注意 的 是 ， 不 是 任何 一 个 公共 仓库 都 提供 nexus-indexer， 对 于 那些 


不 提供 索引 的 仓库 来 说 ， 我 们 束 无 法 对 其 进行 搜索 。 





除了 下 载 使 用 远程 仓库 的 索引 ， 我 们 也 能 为 宾主 仓库 和 代理 仓库 建 
立 索引 。 只 需要 在 仓库 上 右 击 ， 从 弹出 的 快捷 菜单 中 选择 ReIndex 即 
可 ， 如 图 9-15 所 示 。 待 索引 编 繁 任务 完成 之 后 ， 束 能 搜索 该 仓库 所 包含 








的 构件 。 
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图 9-15 “为 Nexus 仓 库 编 纂 索引 


对 于 箱 主 仓库 来 说 ，ReIndex 任 务 会 扫描 该 仓库 包含 的 所 有 构件 建 
立 索 引 。 对 于 代理 仓库 来 说 ，ReIndex 任 务 会 扫描 所 有 缓存 的 构件 建立 
索引 ， 如 宁远 程 仓 库 也 有 索引 ， 则 下 载 后 与 本 地 的 索引 合并 。 对 于 仓库 
组 来 说 ，ReIndex 任 务 会 合并 其 包含 的 所 有 仓库 的 索引 。 








9.5 配置 Maven 从 Nexus 下 载 构件 


6.4 节 与 7.5.1 节 已 经 详细 介绍 了 如 何在 POM 中 为 Maven 配 置 仓 库 和 插 
件 仓库 。 例 如 ， 当 需要 为 项 目 添加 Nexus 私 服 上 的 public 仓 库 时 ， 可 以 按 
代码 清单 9-1 所 示 配 置 。 


代码 清单 9-1 在 POM 中 配置 Nexus 仓 库 


<project > 


<repositories > 
<repository > 
<id >nexus < /id > 
<name >Nexus < /name > 
<url >http://localhost :8081 /nexus /content /groups /public/ < furl > 
<releases > <enabled >true < /enabled > < /releases > 
<snapshots > < enabled >true < /enabled > < /snapshots > 
< /repository > 
< /repositories > 
<pluginRepositories > 
<pluginRepository > 
<id>nexus < /id> 
<name > Nexus < /name > 
<url >http://localhost :8081 /nexus/content/groups /public/ < /url > 
<releases > <enabled >true < /enabled > < /releases > 
< snapshots > < enabled >true < /enabled > < /snapshots > 
</pluginRepository > 
< /pluginRepositories > 


< /project > 





这 样 的 配置 只 对 当前 Maven 项 目 有 效 ， 在 实际 应 用 中 ， 我 们 往往 想 
要 通过 一 次 配置 就 能 让 本 机 所 有 的 Maven 项 目 都 使 用 自己 的 Maven 私 
服 。 这 个 时 候 读者 可 能 会 想到 settings.xml 文 件 ， 该 文件 中 的 配置 对 所 有 
本 机 Maven 项 目 有 效 ， 但 是 settings.xml 并 不 支持 直接 配置 repositories 和 


pluginRepositories。 所 等 Maven 还 提供 了 Profile 机 制 ， 能 让 用 户 将 仓库 配 
置 放 到 setting.xml 中 的 Profile 中 ， 如 代码 清单 9-2 所 示 。 


代码 清单 9-2 ”在 settings.xml 中 配置 Nexus 仓 库 


<settings > 
<profiles > 
<profile> 
<id>nexus </id> 
< repositories > 
< repository > 
<id>nexus < /id> 
< name > Nexus < /name > 
<url >http://localhost :8081 /nexus /content /groups/public/ 
a /url > 
<releases > < enabled >true < /enabled> < /releases > 
< snapshots > < enabled >true < /enabled > < /snapshots > 
< /repository > 
< / repositories > 
<pluginRepositories > 
<pluginRepository > 
<id>nexus </id> 
< name > Nexus < /name > 
<url »http://localhost :8081 /nexus/content /groups/public/ < /url > 
<releases > < enabled >true < /enabled > < /releases > 
< snapshots > < enabled >true < /enabled > < /snapshots > 
< /pluginRepository > 
< /pluginRepositories > 
</profile> 
< /profiles > 
<activeProfiles > 
<activeProfile >nexus < /activeProfile > 


< f/activeProfiles > 


< /settings > 


该 配置 中 使 用 了 一 个 id 为 nexus 的 profile， 这 个 profile 包 含 了 相关 的 
仓库 配置 ， 同 时 配置 中 又 使 用 activeProfile 元 素 将 nexus 这 个 profile 激 活 ， 
这 样 当 执行 Maven 构 建 的 时 候 ， 激 活 的 profile 会 将 仓库 配置 应 用 到 项 目 





中 去 。 关 于 Maven Profile， 本 书后 面 还 会 有 专门 的 章节 进一步 介绍 。 


代码 清单 9-2 中 的 配置 已 经 能 让 本 机 所 有 的 Maven 项 目 从 Nexus 私 服 
下 载 构件 。 细 心 的 读者 可 能 会 注意 到 ，Maven 除 了 从 Nexus 下 载 构件 之 
外 ， 还 会 不 时 地 访问 中 央 仓 库 central， 我 们 希望 的 是 所 有 Maven 下 载 请 
求 都 仅仅 通过 Nexus， 以 全 面 发 挥 私服 的 作用 。 这 个 时 候 就 需要 借助 于 
6.7 市 提 到 的 Maven 镜 像 配 置 了 。 可 以 创建 一 个 匹配 任何 仓库 的 镜像 ， 镜 
像 的 地 址 为 私服 ， 这 样 ，Maven 对 任何 仓库 的 构件 下 载 请 求 都 会 转 到 私 
服 中 。 有 具体 配置 见 代码 清单 9-3。 











代码 清单 9-3 ”配置 镜像 让 Maven 只 使 用 私服 


localhost :8081 /nexus/content /groups/public < /url > 


l >http: a l< /ur 
<releases > <enabled >true < /enabled ‘releases 
< snapshot <enabled >true < nabled E 


pluginRepositor 
i>central id> 
] ttre, tral < /ur 
releases e led >true enabled elease 
snapshot nable tru e e pst 
K yinReposi Į 


关于 镜像 、profile 及 profile 激 活 的 配置 不 再 痪 述 ， 这 里 需要 解释 的 
是 仓 库 及 插件 仓库 配置 ， 和 它们 的 id 都 为 central， 也 就 是 说 ， 轿 兰 了 超级 
POM 中 央 仓 库 的 配置 ， 它 们 的 ua 已 无 关 紧 要 ， 因 为 所 有 请 求 都 会 通过 
镜像 访问 私服 地 址 。 配 置 仓库 及 插件 仓库 的 主要 目的 是 开局 对 快照 版 本 
下 载 的 支持 ， 当 Maven 需 要 下 载 及 布 版 或 快照 版 构件 的 时 候 ， 它 首先 检 
查 central， 看 该 类 型 的 构件 是 否 文 持 ， 得 到 正面 的 回答 之 后 ， 再 根据 锐 
像 匹 配 规 则 转 而 访问 私服 仓库 地 址 。 











9.6 XAJ Nexus 


如 果 只 为 代理 外 部 公共 人 仓库， 那么 Nexus 的 代理 仓库 就 已 经 能 够 完 
全 满足 需要 了 。 对 于 另 一 类 Nexus 仓 库 一 一 宿主 仓库 来 说 ， 它 们 的 主要 
作用 是 储存 组 织 内 部 的 ， 或 者 一 些 无 法 从 公共 仓库 中 获得 的 第 三 方 构 
件 ， 供 大 家 下 载 使 用 。 用 户 可 以 配置 Maven 自 动 部 署 构件 至 Nexus 的 宿 
主 仓库 ， 也 可 以 通过 界面 手动 上 传 构 件 。 


9.6.1 ”使 用 Maven 部 四 构件 全 Nexus 


日 常 开发 生成 的 快照 版 本 构件 可 以 直接 部 署 到 Nexus 中 策略 为 
Snapshot 的 宿主 仓库 中 ， 项 目 正 式 发 布 的 构件 则 应 该 部 署 到 Nexus 中 策 
略为 Release 的 宿主 仓库 中 。POM 的 配置 方式 具体 见 5.4 节 ， 代 码 清单 9-4 
列 出 了 一 段 典 型 的 配置 。 


代码 清单 9-4 配置 Maven 部 署 构 件 至 Nexus 


<project > 


<distributionManagement > 
<repository > 
<id>nexus+eleases < /id> 
z name >Nexus Releases Repository < /name > 
<url >http://localhost :8081 /nexus /content /repositories/releases/ < /url > 
< / repository > 
<snapshotRepository > 
< id >nexus-5napshots < /id> 
<name >Nexus Snapshots Repository < /name > 
<url >http://localhost :8081 /nexus /content /repositories/snapshots/ < /url > 
< /snapshotRepository > 
< /GistributionManagement > 


</project > 


Nexus 的 仓库 对 于 匿名 用 户 是 只 读 的 。 为 了 能 够 部 署 构 件 ， 还 需要 
在 settings.xml 中 配置 认证 信息 ， 如 代码 清单 9-5 所 示 。 


代码 清单 9-5 ”为 部 普 构 件 全 Nexus 配 置 认 证 信息 


<settings > 
<servers > 
<server > 
<id>nexus-releases < /id> 
<username > admin < /username > 
<password > * * * * x </password > 
< /server > 
<server > 
<id>nexus-snapshots < /id> 
<username > admin < /username > 
<password> * k * * x < /password > 
< / server > 
< / servers > 


</settings > 


9.6.2 “手动 部 署 第 三 方 构件 至 Nexus 





某 些 Java Jar 文 件 〈《 如 Oracle) 的 JDBC 驱 动 ， 由 于 许可 证 的 因素 ， 
它们 无 法 公开 地 放 在 公共 仓库 中 。 此 外 ， 还 有 大 量 的 小 型 开源 项 目 ， 它 
们 没有 把 自己 的 构件 分 发 到 中 央 仓 库 中 ， 也 没有 维护 自己 的 仓库 ， 因 此 
也 无 法 从 公共 仓库 获得 。 这 个 时 候 用 户 就 需要 将 这 类 构件 手动 下 载 到 本 
地 ， 然 后 通过 Nexus 的 界面 上 传 到 私服 中 。 








要 上 传 第 三 方 构 件 ， 首 先 选 择 一 个 宿主 仓库 如 3rd party， 然 后 在 页 
面 的 下 方 选择 Artifact Upload 选 项 卡 。 在 上 传 构件 的 时 候 ，Nexus 要 求 用 
户 确定 其 Maven 坐 标 ， 如 果 该 构件 是 通过 Maven 构 建 的 ， 那 么 可 以 在 
GAV Definition 下 拉 列 表 中 选择 From POM， 人 否则 就 选 GAV Parameters. 
用 户 需要 为 该 构件 定义 一 个 Maven 坐 标 ， 例 如 上 传 一 个 Oracle 11g 的 
JDBC 了 驱动 ， 则 可 以 按 图 9-16 所 示 输 入 坐标 。 





定义 好 坐标 之 后 ， 单 击 Select Artifact (s) to Upload 按 扭 从 本 机 选择 
要 上 传 的 构件 ， 然 后 单 击 Add Artifact 按 钮 将 其 加 入 到 上 传 列表 中 。 
Nexus 人 允许 用 户 一 次 上 传 一 个 主 构 件 和 多 个 附属 构件 〈 即 Classifier) 。 
最 后 ， 单 击 页 面 最 下 方 的 Upload Artifact (s) 按钮 将 构件 上 传 到 仓库 
中 。 


Browse Storage | Browse Index | Configuration Mirrors | Summary | Artifact Upload 


Select GAV Definition Source 
GAV Definition: GAV Parameters Y & 


Auto Guess: vi @ 

Group: com.oracle.driver 
Artifact: jdbc-driver 
Version: iig 


Packaging: 








图 ojdbcsjarejar 











图 9-16 手动 上 传 构件 至 Nexus 


9.7 “Nexus 的 权限 管理 


在 组 织 中 使 用 Nexus 的 时 候 往往 会 有 一 些 安全 性 需求 ， 例 如 希望 只 
有 管理 员 才 能 配置 Nexus， 只 用 些 团 队 成 员 才 能 部 署 构件 ， 或 者 更 细 
一 些 的 要 求 ， 例 如 每 个 项 目 都 有 目 己 的 Nexus 和 宿主 仓库 ， 且 只 能 部 普 项 
目 构 件 至 该 仓库 中 。Nexus 提 供 了 全 面 的 权限 控制 特性 ， 能 让 用 户 自 由 
地 根据 需要 配置 Nexus 用 户 、 角 色 、 权 限 等 。 


9.7.1 Nexus 的 访问 控制 模型 


Nexus 是 基于 权限 (Privilege) 做 访问 控制 的 ， 服 务 器 的 每 一 个 资源 
都 有 相应 的 权限 来 控制 ， 因 此 用 户 执行 特定 的 操作 时 就 必须 拥有 必要 的 
权限 。 管 理 员 必 须 以 角色 Role) 的 方式 将 权限 赋予 Nexus 用 户 。 例 如 
要 访问 Nexus 界 面 ， 就 必须 拥有 Status- (read) 这 个 权限 ， 而 Nexus 默 认 
配置 的 角色 UI: Basic UI Privileges 束 包含 了 这 个 权限 ， 再 将 这 个 角色 分 
配给 菜 个 用 户 ， 这 个 用 户 就 能 访问 Nexus 界 面 了 。 





用 户 可 以 被 赋予 一 个 或 者 多 个 角色 ， 和 角色 可 以 包含 一 个 或 者 多 个 权 
限 ， 和 角色 还 可 以 包含 一 个 或 者 多 个 其 他 角色 。 





Nexus 预 定义 了 三 个 用 户 ， 以 admin 登 录 后 ， 单 击 页 面 左 边 导航 栏 中 
的 User 链 接 ， 就 能 看 到 所 有 已 定义 用 户 的 列表 ， 如 图 9-17 所 示 。 


= Refresh GJ Add... ~ @& Delete All Configured Users + 
User D Realm Name > Email Roles 


admin defaut Administrator changeme@yourcompany.com Nexus Administrator Role 


deployment defaut Deployment User changeme1@yourcompany.com Repo: All Repositories (Full Control), Nexu 





anonymous defaut Nexus Anonynmous User changeme2@yourcompany.com Nexus Anonymous Role, Repo: Al Repos 


图 9-17 NexusfW fize SA 





这 三 个 用 户 对 应 了 三 个 权限 级 别 : 


‘admin: 该 用 户 拥 有 对 Nexus 服 务 的 完全 控制 ， 默 认 密 码 为 


admin123。 


‘deployment: 该 用 户 能 够 访问 Nexus， 浏 览 仓 库 内 容 ， 搜 索 ， 并 且 
上 传 部 署 构件 ， 但 是 无 法 对 Nexus 进 行 任何 配置 ， 默 认 密 码 为 
deployment123。 





‘anonymous: 该 用 户 对 应 了 所 有 未 登录 的 匿名 用 户 ， 它 们 可 以 浏览 
仓库 并 进行 搜索 。 


在 Users 页 面 中 ， 管 理 员 还 可 以 添加 用 户 。 单 击 上 方 的 Add 按 钮 ， 选 
择 Nexus User， 然 后 在 用 户 配 置 面 板 中 配置 要 添加 用 户 的 ID、 名 称 、 
Email、 状 态 、 密 码 以 及 包含 的 角色 ， 最 后 单 击 Save 按 钮 即 可 。 


可 以 单 击 任何 一 个 用 户 ， 然 后 选择 页 面 下 方 的 Role Tree 选项 卡 ， 以 
树 形 结构 详细 地 查看 该 用 户 所 包含 的 角色 以 及 进一步 的 权限 。 图 9-18 所 
示 是 anonymous 用 户 的 角色 树 。 


Nexus Anonynmous User 
Config Role Tree | Privilege Trace 





& Refresh 


J) Nexus Anonynmous User 
A Nexus Anonymous Role 
sj <>) Ul Repository Browser 
图 Read Repository Status 
=] Repositories - (read) 
=] Repository Groups - (read) 
BIU Search 
图 Checksum Search 
=] Search Repositories 
E] Artifact Download 
= Repository Content Classes Component - (read) 
=] Repository Types - (read) 
=] Status - (read) 
=] User Forgot Password - (create,read) 
=] User Forgot User id - (create,read) 
3-3 Repo: All Repositories (Read) 
=] All M1 Repositories - (read) 
=] All M2 Repositories - (read) 
=] All Repositories - (view) 





图 9-18 anonymous 用 户 的 角色 树 


理解 各 个 角色 的 意义 对 于 权限 管理 至 关 重 要 。Nexus 预 定义 的 一 些 
常用 且 重 要 的 角色 包括 : 


‘UI: Basic UI Privileges: 包含 了 访问 Nexus 界 面 必 须 的 最 基本 的 权 
限 。 


‘UI: Repository Browser: 包含 了 浏览 仓库 页 面 所 需要 的 权限 。 





‘Ul: Search: 包含 了 访问 快速 搜索 栏 及 搜索 页 面 所 需要 的 权限 。 





‘Repo: All Repositories (Read) : 给 予 用 户 读 取 所 有 仓库 内 容 的 权 
限 ， 没 有 仓库 的 读 权 限 ， 用 户 将 无 法 在 仓库 页 面 上 看 到 实际 的 仓库 内 
， 也 无 法 使 用 Maven 从 仓库 下 载 构件 。 


ot 


‘Repo: All Repositories (Full Control) : 给 予 用 户 完全 控制 所 有 仓 
库 内 容 的 权限 。 用 户 不 仪 可 以 浏览 、 下 载 构件 ， 还 可 以 部 车 构件 及 删除 
仓库 内 容 。 


Nexus 包 含 了 一 个 特殊 的 匿名 用 户 角 色 (Nexus Anonymous 
Role) ， 默 认 配 置 下 没有 登录 的 用 户 都 会 拥有 该 匿名 角色 的 权限 。 这 个 
匿名 用 户 角 色 实 际 包含 了 上 述 所 列 角 色 中 ， 除 Repo: All 
Repositories (Full Control) 之 外 的 所 有 角色 所 包含 的 权限 。 也 就 是 说 ， 
匿名 用 户 可 以 访问 基本 的 Nexus 界 面 、 浏 览 仓 库 内 容 及 搜索 构件 。 








除 上 述 角 色 之 外 ，Nexus 还 预定 义 了 很 多 其 他 角色 ， 它 们 往往 都 对 
应 了 一 个 Nexus 的 功能 。 例 如 ，UI: Logs and Config Files 包 含 了 访问 系 
统 日 志文 件 及 配置 文件 所 需要 的 权限 。 


9.7.2 ”为 项 目 分 配 独 立 的 仓库 





在 组 织 内 部 ， 如 果 所 有 项 目 都 部 著 快 照 及 发 布 版 构件 至 同样 的 仓 
库 ， 束 会 存在 潜在 的 冲突 及 安全 问题 ， 我 们 不 想 让 项 目 A 的 部 署 影响 到 
项 目 B， 反 之 亦 然 。 解 决 的 方法 残 是 为 每 个 项 目 分 配 独 立 的 仓库 ， 并 且 
只 将 仓库 的 部 署 、 修 改 和 删除 权限 赋予 该 项 目的 成 员 ， 其 他 用 户 只 能 读 
取 、 下 载 和 搜索 该 仓库 的 内 容 。 





假设 项 目 名 称 为 foo， 首 先 为 该 项 目 建立 两 个 宿主 仓库 Foo Snapshots 
和 Foo Releases， 分 别 用 来 部 署 快照 构件 和 发 布 构件 。 有 具体 步骤 参见 
9.3.3 节 ， 这 里 不 再 歼 述 。 


有 了 仓库 之 后 ， 就 需要 创建 基于 仓库 的 增 、 删 、 改 、 查 权限 。 在 
Nexus 中 ， 这 样 的 权限 是 基于 Repository Target 建 立 的 ，Repository Target 
实际 上 是 一 系列 正则 表达 式 ， 在 访问 仓库 某 路 径 下 内 容 的 时 候 ，Nexus 
会 将 仓库 路 径 与 Repository Target 的 正则 表达 式 一 一 匹配 ， 以 检查 权限 
是 否 正确 。 








单 击 左边 导航 栏 中 的 Repository Targets 链 接 ， 就 能 看 到 图 9-19 所 示 
的 页 面 。 图 中 选中 了 Al (Maven2) 这 一 Repository Target， 在 下 方 可 以 
看 到 它 包含 了 一 个 值 为 “.*” 的 正则 表达 式 ， 表 示 该 Repository Target fies 
匹配 仓库 下 的 任何 路 径 。 


Targets 

= Refresh 3J Add @ Delete 

Name « Repository Type 
All (Maven' maven1 

All (Maven2) maven2 

上 but sources (Maven2) maven2 


All Metadata (Maven2) maven2 


Repository Target Configuration 


Name All (Maven2) 


Repository Type maven2 


Pattern Expression: 





图 9-19 Nexus 的 Repository Target 





下 一 步 就 是 基于 该 Repository Target 和 Foo Releases. Foo Snapshots 
两 个 仓库 建立 权限 。 单 击 页 面 左边 导航 栏 中 的 Privileges 链 接 进入 权限 页 
面 ， 然 后 单 击 Add 按 钮 ， 选 择 Repository Target Privilege。 图 9-20 所 示 为 
创建 对 应 于 Foo Releases 的 权限 。 





New Repository Target Privilege 


Name Foo Releases 


Description Foo Releases 
Type 
Repository Foo Releases (Repo) 


Repository Target All (Maven2) 





图 9-20 “为 Foo Releases 创 建仓 库 权 限 


图 9-20 中 选择 了 Foo Releases 人 仓库 和 All (Maven2) ， 表 示 创 建 匹 配 
Foo Releases 仓 库 任何 路 径 的 权限 。 单 击 Save 按 钮 之 后 ， 就 能 在 权限 列 
表 中 看 到 相应 的 增 、 删 、 改 、 查 权限 ， 如 图 9-21 所 示 。 





Foo Releases - (create) true Repository Target All (Maven2) Foo Releases 
Foo Releases - (delete) true Repository Target All (Maven2) Foo Releases 


Foo Releases - (read) true Repository Target All (Maven2) Foo Releases 





Foo Releases - (update) true Repository Target All (Maven2) Foo Releases 


图 9-21 Foo Releases 仓 库 的 增 、 删 、 改 、 查 权限 


然后 ， 遵 循 同样 的 步骤 ， 为 Foo Snapshots 建 立 增 、 删 、 改 、 查 权 
限 。 


下 一 步 是 创建 一 个 包含 上 述 权 限 的 角色 。 单 击 导航 栏 中 的 Roles 进 
入 角色 页 面 ， 再 单 击 页 面 上 方 的 Add 按 钮 并 选择 Nexus Role。 图 9-22 所 
示 为 将 之 前 建立 的 权限 加 入 到 该 角色 中 。 


Role Id 
Name 
Description 


Session Timeout 


Selected Roles / Privileges 
=] Foo Snapshots - (delete) 
图 Foo Snapshots - (create) 
E] Foo Snapshots - (read) 


=] Foo Releases - (delete) 
=] Foo Releases - (update) 
=) Foo Releases - (create) 
=] Foo Releases - (read) 


=] Foo Snapshots - (update) 





foo-deployer 
Foo Deployer 
Foo Deployer 


30 


Available Roles / Privileges 


_) Nexus Administrator Role 

__] Nexus Anonymous Role 

__] Nexus Deployment Role 

_] Nexus Developer Role 

„Repo: All Repositories (Full Control) 
„) Repo: All Repositories (Read) 

„J Ut Base Ul Privileges 

J Ut Group Administration 

„J Uk LDAP Administrator 

„Uk Logs and Config Files 

„J Uk Plugin Console 

J Ut Privilege Administration 

__) Uk Repository Administration 

J Uk Repository Browser 

-J Uk Repository Target Administration 





图 9-22 ”创建 Foo Deployer 角 色 


角色 创建 完成 之 后 ， 根 据 需 要 将 其 分 配给 Foo 项 目的 团队 成 员 。 这 
样 ， 其 他 团队 的 成 员 默 认 只 能 读 取 Foo Releases 和 Foo Snapshots 的 内 容 ， 
而 拥有 Foo Deployer 角 色 的 用 户 就 可 以 执行 部 署 构 件 等 操作 。 


9.8 Nexus 的 调度 任务 


Nexus 提 供 了 一 系列 可 配置 的 调度 任务 来 方便 用 户 写 理 系 统 。 用 户 
可 以 设 定 这 些 任务 运行 的 方式 ， 例 如 每 天 、 每 周 、 手 动 等 。 调 度 任务 会 
在 适当 的 时 候 在 后 从 运行。 当然 ， 用 户 还 是 能 够 在 界面 观察 它们 的 状态 
的 。 





要 建立 一 个 调度 任务 ， 单 击 左 边 导航 栏 中 的 Scheduled Tasks 链 接 ， 
然后 在 右边 的 界面 上 方 单 击 Add 按 钮 ， 接 着 就 能 看 到 图 9-23 所 示 的 界 
面 。 用 户 可 以 根据 自己 的 需要 ， 选 择 任务 类 型 ， 并 配置 其 运行 方式 。 











Scheduled Tasks 
Refresh © Add @ Delete 


Enabled Name > Status 
New Scheduled Task 





Scheduled Task Configuration 


Enabled Je 


Name rebuild maven metadata 
Task Type 





Download Indexes 
Empty Trash 
Evict Unused Proxied Items From Repository Caches 
Expire Repository Caches 
Publish Indexes 
Alert Email Purge Nexus Timeiine 
Recurrence Rebuild Maven Metadata Files 
Reindex Repositories 
Remove Snapshots From Repository 
Schedule Settings Synchronize Shadow Repository 
Without recurrence, this service can only be run manually. 





图 9-23 ”创建 Nexus 调 度 任务 


Nexus 包 含 了 以 下 几 种 类 型 的 调度 任务 : 








‘Download Indexes: 为 代理 仓库 下 载 远 程 索 引 。 


-Empty Trash: 清空 Nexus 的 回收 站 ， 一 些 操作 (如 删除 仓库 文件 》 
实际 是 将 文件 移 到 了 回收 站 中 。 





:Evict Unused Proxied Items From Repository Caches: 删除 代理 仓库 
中 长 期 未 被 使 用 的 构件 缓存 。 


-Expire Repository Caches: Nexus 为 代理 仓库 维护 了 远程 仓库 的 信 
奶 以 避免 不 必要 的 网 络 流量 ， 该 任务 清空 这 些 信息 以 强制 Nexus 去 重新 
获取 远程 仓库 的 信息 。 








‘Publish Indexes: 将 仓库 索引 发 布 成 可 供 m2eclipse 和 其 他 Nexus 使 
用 的 格式 。 


-Purge Nexus Timeline: 删除 Nexus 的 时 间 线 文件 ， 该 文件 用 于 建立 
系统 的 RSS 源 。 





-Rebuild Maven Metadata Files: 基于 仓库 内 容重 新 创建 仓库 元 数据 
文件 maven-metadata.xml， 同 时 重新 创建 每 个 文件 的 校 验 和 md5 和 shal 。 





.Reindex Repositories: 为 仓库 编纂 索引 。 


-Remove Snapshots From Repository: 以 可 配置 的 方式 删除 仓库 的 快 
照 构 件 。 


.Synchronize Shadow Repository: 同步 虚拟 仓库 的 内 容 〈 服 务 于 
Maven 1) 。 


9.9 其 他 私服 软件 


Nexus 不 是 唯一 的 Maven 私 服 软件 ， 正 如 本 章 一 开始 所 提 到 的 ， 用 
户 还 有 另外 两 个 选择 ， 它 们 分 别 为 Apache 的 Archiva 与 JFrog 的 


Artifactory. 








Archiva 可 能 是 历史 最 长 的 Maven 私 服 软 件 ， 它 早 在 2005 年 就 作为 
Apache Maven 的 一 个 子 项 目 存 在 ， 到 2008 年 3 月 成 为 了 Apache 软 件 基 金 
会 的 顶级 项 目 。 到 本 书 编写 的 时 候 ，Archiva 的 最 新 版 本 为 1.3.1。 


读者 可 以 访问 http://archiva.apache.org 以 具体 了 解 Archiva， 其 站 点 提 
供 了 一 些 入 门 指南 及 邮件 列表 等 信息 。Archiva 的 下 载 地 址 
为 http://archiva.apache.org/download.html。 图 9-24 显 示 了 Archiva 的 一 个 
仓库 管理 界面 。 


> Administration - Repositorios 
archiva  、 


AT7 Arhiva Umnaged interne Repository 





图 9-24 ”Archiva 的 仓库 管理 界面 


在 Nexus 发 布 之 前 ， 笔 者 曾 一 度 是 Artifactory 的 忠实 用 户 ， 当 时 它 是 
唯一 的 支持 从 用 户 界 面 配置 仓库 的 私服 。Artifactory 的 一 大 特点 是 使 用 
数据 库 来 存储 仓库 内 容 。 读 者 可 以 自行 访问 下 rog 站 点 以 了 解 更 多 信 
息 : http://www.jfrog.org/products.php。Artifactory 目 前 的 最 新 版 本 为 
2.2.5， 其 下 载 地 址 为 http:Wwww.jfrog.org/download.php。 图 9-25 所 示 是 
Artifactory 的 仓库 浏览 界面 。 





Logged in as admin | Log Gur 





fk maven-plugin-anno-1.2.4-sources.ja 
d 区 maven-plugin-anno-1.2.4.jar 








图 9-25 ”Artifactory 的 仓库 浏览 界面 


细心 的 读者 会 及 现 ，Nexus 的 主 色 调 为 蓝 色 ，Archiva 的 主 色调 为 检 
色 ， 而 Artifactory 的 主 色调 为 绿色 ， 这 或 许 是 各 个 团队 自我 风格 的 一 种 
体现 吧 。 


9.10 ”小 结 


建立 并 维护 自己 的 私服 是 使 用 Maven 必 不 可 少 的 一 步 ，Maven 私 服 
软件 有 Nexus、Archiva 和 Artifactory， 它 们 都 提供 了 开源 的 版 本 供用 户 
下 载 。 本 章 详细 介绍 了 Nexus 的 安装 和 使 用 ， 包 括 如 何 分 辨 各 种 类 型 的 
仓库 、 如 何 建立 仓库 索引 和 搜索 构件 、 如 何 使 用 权限 管理 功能 、 如 何 使 
用 调度 任务 功能 等 。 除 了 这 些 功 能 之 外 ，Nexus 还 有 很 多 有 趣 的 特性 ， 
如 RSS 源 、 日 志 浏 览 及 配置 等 ， 用 户 可 以 从 友好 的 界面 中 学 习 使 用 。 


除了 Nexus 本 身 ， 本 章 还 详 述 了 如 何 配置 Maven 从 私服 下 载 构件 ， 
以 及 如 何 发 布 构件 至 私服 供 他 人 使 用 。 结 合 了 Nexus 的 帮助 之 后 ， 再 使 
用 Maven 时 融会 如 虎 添 避 。 


第 10 音 ”使 用 Maven 进 行 测 试 
本 章 内 容 
-account-captcha 
-maven-surefire-plugin 简 介 


- 跳 过 测试 





:动态 指定 要 运行 的 测试 用 例 
包含 与 排除 测试 用 例 
测试 报告 

.运行 TestNG 测 试 

重用 测试 代码 

:小结 


随 着 敏捷 开发 模式 的 日 益 流 行 ， 软 件 开 发 人 员 也 越 来 越 认 识 到 日 常 
编程 工作 中 单元 测试 的 重要 性 。Maven 的 重要 职责 之 一 就 是 自动 运行 单 
元 测试 ， 它 通过 maven-surefire-plugin 与 主流 的 单元 测试 框架 JUnit 3、 
JUnit 4 以 及 TestNG 集 成 ， 并 且 能 够 自动 生成 丰富 的 结果 报告 。 本 章 将 介 








绍 Maven 关 于 测试 的 一 些 重 要 特性 ， 但 不 会 深入 解释 单元 测试 框架 本 号 
及 相关 技巧 ， 重 点 是 介绍 如 何 通过 Maven 控 制 单 元 测试 的 运行 。 





除了 测试 之 外 ， 本 章 还 会 进一步 丰富 账户 注册 服务 这 一 背景 案例 ， 
引入 其 第 3 个 模块 : account-captcha。 


10.1 account-captcha 


在 讨论 maven-surefire-plugin 之 前 ， 本 章 先 介绍 实现 账户 注册 服务 的 
account-captcha 模 块 ， 该 模块 负责 处 理 账 户 注 册 时 验证 码 的 key 生 成 、 图 
片 生成 以 及 验证 等 。 读 者 可 以 回顾 第 4 章 的 背景 案例 以 获得 更 具体 的 需 
求 信息 。 





10.1.1 account-captcha 的 POM 


该 模块 的 POM (Project Object Model， 项 目 对 象 模 型 ) 还 是 比较 简 
单 的 ， 内 容 见 代码 清单 10-1。 


代码 清单 10-1 _ account-captcha 的 POM 


< project xmins = "http:// maven. apache.org/ POM/ 4.0.0" xmins: xsi = "http:// 
www. w3.org/2001 /XMLSchema-instance" 
xsi: schemaLocation = "http:// maven. apache.org/ POM/ 4.0.0 http:// maven. 
apache. org/maven-v4_0_0.xsd" > 
<modelVersion >4.0.0 </modelVersion > 
<parent > 
<groupId >com. juvenxu. mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId > 
<version >1.0.0-SNAPSHOT < /version > 
</parent > 


<artifactId >account-captcha < /artifactId> 
<name >Account Captcha < /name > 


<properties > 
<kaptcha. version >2.3 < /kaptcha. version > 
< /properties > 


< dependencies > 

< dependency > 
<groupId >com. google. code. kaptcha < /groupId > 
<artifactId>kaptcha < /artifactId> 
<version > $ {kaptcha. version} < /version > 
<classifier >jdki5 </classifier > 

< /dependency > 

< dependency > 
<groupId >org. springframework < /groupId > 


rtifactId >spring-core < /artifactId > 
GA s Sae a 
lependency > 
< routa >org. Springframework < /groupId > 
<artifactId >spring-beans < /artifactId> 
< /dependency > 
< dependency > 
groupId > springframework < /groupId > 
<artifactid >spr ing-context < /artifactid > 
< / dependency > 
< dependency > 
<groupId >junit </groupId > 
<artifactId >junit </artifactId> 
< /dependency > 
/ dependencies > 


< repository -Ġ: 
<id>sonat J </id> 
ame > Sonatype Forge < /name > 
<url> ee: // repository. sonatype.org/ content / groups / forge/ < /url > 


ue < /enabled > 





< /repository > 
/repositories > 


</project > 


首先 POM 中 的 第 一 部 分 是 父 模块 声明 ， 如 同 account-email、 

account-persist 一 样 ， 这 里 将 父 模块 声明 为 account-parent。 紧 接着 是 该 项 
目 本 身 的 artifactId 和 名 称 ，groupId 和 version 没 有 声明 ， 将 自动 继承 自 父 
模块 。 再 往 下 声明 了 一 个 Maven 属 性 kaptcha.version， 该 属性 用 在 依赖 声 
明 中 ，account-captcha 的 依赖 除了 SpringFramework 和 JUnit 之 外 ， 还 有 一 
个 com.google.code.kaptcha: kaptcha。Kaptcha 是 一 个 用 来 生成 验证 码 

(Captcha) 的 开源 类 库 ，account-captcha 将 用 它 来 生成 注册 账户 时 所 需 
要 的 验证 码 图 片 ， 如 果 想 要 了 解 更 多 关于 Kaptcha 的 信息 ， 可 以 访问 其 
项 目 主 页 : http://code.google.com/p/kaptcha/。 


POM 中 SpringFramework 和 JUnit 的 依赖 配置 都 继承 自 父 模块 ， 这 里 
不 再 獒 述 。Kaptcha 依 赖 声 明 中 version 使 用 了 Maven 属 性 ， 这 在 之 前 也 已 
经 见 过 。 需 要 注意 的 是 ，Kaptcha 依 赖 还 有 一 个 classifier 元 素 ， 其 值 为 
jdk5，Kaptcha 针 对 Java 1.5 和 Java 1.4 提 供 了 不 同 的 分 发 包 ， 因 此 这 里 使 
用 classifier 来 区 分 两 个 不 同 的 构件 。 





POM 的 最 后 声明 了 Sonatype Forge 这 一 公共 仓库 ， 这 是 因为 Kaptcha 
并 没有 上 传 的 中 央 仓 库 ， 我 们 可 以 从 Sonatype Forge 仓 库 获 得 该 构件 。 
如 果 有 自己 的 私服 ， 就 不 需要 在 POM 中 声明 该 仓库 了 ， 可 以 代理 
Sonatype Forge 仓 库 ， 或 者 直接 将 Kaptcha 上 传 到 自己 的 仓库 中 。 





最 后 ， 不 能 忘记 把 account-captcha 加 入 到 聚合 模块 (也 是 父 模 块 ) 


account-parent 中 ， 见 代码 清单 10-2。 


代码 清单 10-2 ”将 account-captcha 加 入 到 聚合 模块 account-parent 





<artifactid >account-parent < /artifactId > 
<version >1.0.0-— SNAPSHOT < /version > 


< packaging >pom < /packaging > 


<name >Account Parent < / name > 
<modules > 


<module >account-email < /module > 
<module >account-persist < /module > 






<module >account-captcha < /module > 
< /modules > 


< / project > 


10.1.2 account-captcha 的 主 代码 


account-captcha 需 要 提供 的 服务 是 生成 随机 的 验证 码 主键 ， 然 后 用 
户 可 以 使 用 这 个 主键 要 求 服 务 生成 一 个 验证 码 图 片 ， 这 个 图 瞩 对 应 的 值 
应 该 是 随机 的 ， 基 后 用 户 用 肉眼 读 取 图 片 的 值 ， 并 将 验证 码 的 主键 与 这 
个 值 交 给 服务 进行 验证 。 这 一 服务 对 应 的 接口 可 以 定义 ， 如 代码 清单 





10-3 所 示 o 
代码 清单 10-3 AccountCaptchaService.java 


package com. juvenxu. mvnbook. account. captcha; 
import java.util.List; 
public interface AccountCaptchaService 


String generateCaptchaKey () 


throws AccountCaptchaException; 


byte[] generateCaptchalImage( String captchaKey ) 


throws AccountCaptchaException; 


boolean validateCaptcha( String captchaKkey, String captchaValue ) 


throws AccountCaptchaException; 
List <String> getPreDefinedTexts (); 


void setPreDefinedTexts (List <String > preDefinedTexts ); 


很 显然 ，generateCaptchaKey〈) 用 来 生成 随机 的 验证 码 主键 ， 
generateCaptchalmage () 用 来 生成 验证 码 图 片 ， 而 validateCaptcha © 
用 来 验证 用 户 反 馈 的 主键 和 值 。 


该 接口 定义 了 额外 的 getPreDefinedTexts () 和 
setPreDefinedTexts () 方法 ， 通 过 这 一 组 方法 ， 用 户 可 以 预定 义 验 证 码 
图 片 的 内 容 ， 同 时 也 提高 了 可 测试 性 。 如 果 AccountCaptchaService 永 远 
生成 随机 的 验证 码 图 片 ， 那 么 没有 人 工 的 参与 就 很 难 测 试 该 功能 。 现 
在 ， 服 务 允 许 传 入 一 个 文本 列表 ， 这 样 就 可 以 基于 这 些 文本 生成 验证 
码 ， 那 么 我 们 也 就 能 控制 验证 码 图 片 的 内 容 了 。 





为 了 能 够 生成 随机 的 验证 码 主键 ， 引 入 一 个 RandomGenerator 类 ， 
见 代码 清单 10-4。 


代码 清单 10-4 RandomGenerator.java 


package com. jJuvenxu.mvnbook. account. captcha; 

import java.util. Random; 

public class RandomGenerator 
private static String range = " 


0123456789 abcdefahijkimnoparstuvwxyz"; 
public static synchronized String getRandomString () 
Random random = new Random (); 

StringBuffer result = new StringBuffer (); 

for (inti OSI <8; i+ +) 


result.append( range 


. charAt ( random. next Int ( range.length() ) ) ); 


return result.toString(); 


RandomGenerator 类 提供 了 一 个 静态 且 线 程 安全 的 


getRandomString O 方法 。 该 方法 生成 一 个 长 度 为 8 的 字符 串 ， 每 个 字 
符 都 是 随机 地 从 所 有 数字 和 字母 中 挑选 ， 这 里 主要 是 使 用 了 
java.util.Random 类 ， 其 nextInt (int n) 方法 会 返回 一 个 大 于 等 于 0 且 小 于 
n 的 整数 。 代 码 中 的 字段 range 包 含 了 所 有 的 数字 与 字母 ， 将 其 长 度 传 给 
nextint O 方法 后 就 能 获得 一 个 随机 的 下 标 ， 再 调用 range.charAt ©) 就 
可 以 随机 取得 一 个 其 包含 的 字符 了 。 

















现在 看 AccountCaptchaService 的 实现 类 
AccountCaptchaServiceImpl。 首 先 需要 初始 化 验证 码 图 片 生成 器 ， 见 代 
码 清 单 10-5。 


代码 清单 10-5 ”AccountCaptchaServiceImpl.java 的 


afterPropertySet © 方法 








import javax. imageio. ImagelIO; 
import org. springframework. beans. factory. InitializingBean; 


import com. google. code. kaptcha. impl. DefaultKaptcha; 


import com. google. code. kaptcha. util.Config; 


public class AccountCaptchaServicelImpl 


implements AccountCaptchaService, InitializingBean 
private DefaultKaptcha producer; 


public void afterPropertiesSet () 


producer new DefaultKaptcha(); 
producer. setConfig( new Config( new Properties () ) }; 


AccountCaptchaServiceImpl 实 现 了 SpringFramework 的 





InitializingBean 接 口 ， 该 接口 定义 了 一 个 方法 afterPropertiesSet () ， 该 
方法 会 被 SpringFramework 初 始 化 对 象 的 时 候 调 用 。 该 代码 清单 中 使 用 
该 方法 初始 化 验证 码 生 成 器 producer， 并 且 为 producer 提 供 了 默认 的 配 
Ho 


接着 AccountCaptchaServiceImpl 需 要 实现 generateCaptchaKey O 77 
法 ， 见 代码 清单 10-6。 


代码 清单 10-6 AccountCaptchaServiceImpl.java 


generateCaptchaKey () 方法 


private Map <String, String> captchaMap = new HashMap <String, String> (); 
private List <String > preDefinedTexts; 
private int textCount = 0; 


public String generateCaptchakey () 


i String key = RandomGenerator. getRandomString({); 
String value getCaptchaText {); 
captchaMap. put ( key, value ); 
return key; 

} 


public List <String > getPreDefinedTexts (} 


return preDefinedTexts; 


} 
public void setPreDefinedTexts( List <String > preDefinedTexts ) 
í 
this. preDefinedTexts = preDefinedTexts; 
private String getCaptchaText () 
1 


if ( preDefinedTexts != null && !preDefinedTexts. isEmpty () ) 


String text = preDefinedTexts. get ( textCount ); 
textCount (textCount +1) $ preDefinedTexts.size(); 


return text; 


} 
else 
{ 
return producer. createText (); 
} 


上 述 代码 清单 中 的 generateCaptchaKey〈) 首先 生成 一 个 随机 的 验 
证 码 主键 ， 每 个 主键 将 和 一 个 验证 码 字 符 串 相关 联 ， 然 后 这 组 关联 会 被 
存储 到 captchaMap 中 以 备 将 来 验证 。 主 键 的 目的 仅仅 是 标识 验证 码 图 
请 ， 其 本 里 没 有 实际 的 意义 。 代 码 清 蛙 中 的 getCaptchaText〈) 用 来 生 





成 验证 码 字符 串 ， 当 preDefinedTexts 不 存在 或 者 为 空 的 时 候 ， 就 是 用 验 
证 码 图 片 生成 颖 producer 创 建 一 个 随机 的 字符 串 ， 当 preDefinedTexts 不 
为 空 的 时 候 ， 就 顺序 地 循环 该 字符 串 列表 读 取 值 。preDefinedTexts 有 其 
对 应 的 一 组 get 和 set 方 法 ， 这 样 就 能 让 用 户 预 定义 验证 码 字符 串 的 值 。 


有 了 验证 人 码 图 片 的 主键 ，AccountCaptchaServiceImpl1 就 需要 实现 
generateCaptchalmage O 方法 来 生成 验证 码 图 片 ， 见 代码 清单 10-7。 


代码 清单 10-7 AccountCaptchaServiceImpl.java 的 


generateCaptchalmage () 方法 


public byte[] generateCaptchalmage( String captchaKey ) 
throws AccountCaptchaException 
String text captchaMap. get ( captchakey ); 
1E {tekt == pult) 


throw new AccountCaptchaException ( "Captch key'" + captchaKey + "'not 


BufferedImage image = producer. createImage{ text ) ; 


ByteArrayOutputStream out new ByteArrayOutputStream (); 


ImagelO.write(imace, "jpg", out ); 
catch ( IOException e ) 


throw new AccountCaptchaException( "Failed to write captcha stream!", e ); 
b 
} 


return out. toByteArray (); 


为 了 生成 验证 码 图 片 ， 就 必须 先 得 到 验证 码 字 符 吕 的 值 ， 代 码 清单 
中 通过 使 用 主键 来 得 询 captchaMap 获 得 该 值 ， 如 采 值 不 存在 ， 就 抛 出 并 
常 。 有 了 验证 码 字符 串 的 值 之 后 ，generateCaptchaImage〈) 方法 就 能 通 
过 producer 来 生成 一 个 BufferedImage， 随 后 的 代码 将 这 个 图 片 对 象 转换 
成 jpg 格 式 的 字 节 数组 并 返回 。 有 了 该 字 市 数组 ， 用 户 束 能 随意 地 将 其 
保存 成 文件 ， 或 者 在 网 页 上 显示 。 


最 后 是 简单 的 验证 过 程 ， 见 代码 清单 10-8。 


代码 清单 10-8 ”AccountCaptchaServiceImpl.java 的 


validateCaptcha () 方法 


public boolean validateCaptcha( String captchaKey, String ca 


throws AccountCaptchaException 


String text = captchaMap. get ( captchaKey ); 
if ext ill 
throw new AccountCaptchaException ( "Captch key'" + captchaKey + "'not 
found!" ); 
} 
E e equals pt lue } 
captchaMap. remove ( pt 
tur 1€ 
了 


return false; 


PS AY 


用 记得 到 了 验证 码 图 片 以 及 主键 后 ， 残 会 识别 图 片 中 所 包含 的 字符 





串 信息 ， 然 后 将 此 验证 码 的 值 与 主键 一 起 反馈 给 validateCaptcha O 方 
法 以 进行 验证 。validateCaptcha O 通过 主键 找到 正确 的 验证 码 值 ， 然 
后 与 用 户 提 供 的 值 进行 比 对 ， 如 果 成 功 ， 则 返回 true。 


当然 ， 还 需要 一 个 SpringFramework 的 配置 文件 ， 它 在 资源 目录 
src/main/resources/ 下 ， 名 为 account-captcha.xml， 见 代码 清单 10-9。 


代码 清单 10-9 account-captcha.xml 


<?xml version = "1.0" encoding = "UTF —8"?> 







‘schema / beans" 
instance" 


<beans xmlns = "http://www. spring 
xmins:xsi ="http://www.w3.org/ 





chemaLocation = "ht p? e rG schema / beans 
vw. springframewor ana osie ma / beans / spring- sai ans -2.5. xsd" > 
<bean id = "“accountCaptchaService" 
class = "com. juvenxu. mvnbook. account. captcha. AccountCaptcha viceImp1" 


“ / bean > 


< / beans > 


这 是 一 个 最 简单 的 SpringFramework 配 置 ， 它 定义 了 一 个 id 为 
accountCaptchaService 的 bean， 其 实现 为 刚才 讨论 的 


AccountCaptchaServiceImpl. 


10.1.3 account-captcha 的 测试 代码 


测试 代码 位 于 srctesUjava 目 录 ， 其 包 名 也 与 主 代 人 码 一 致 ， 为 
com.juvenxu.mvnbook.account.captcha。 首 先 看 一 下 简单 的 


RandomeGeneratorTest， 见 代码 清单 10-10。 


代码 清单 10-10 RandomeGeneratorTest.java 


package com. juvenxu.mvnbook. account. captcha; 
import static org. junit.Assert.assertFalse; 


import java.util. HashSet; 
import java.util.Set; 


import org. junit.Test; 


public class RandomGeneratorTest 
{ 
@ Test 
public void testGetRandomString () 
throws Exception 


{ 
Set <String> randoms = new HashSet <String>(100 ); 
for (int i= 0; i < 100; i++ ) 
{ 


String random RandomGenerator. getRandomString (); 
assertFalse( randoms. contains (random ) }; 


randoms.add({ random ); 


该 测试 用 例 创 建 一 个 初始 容量 为 100 的 集合 randoms， 然 后 循环 100 
次 用 RandomGenerator 生 成 随机 字符 串 并 放 入 randoms 中 ， 同 时 每 次 循环 





都 检查 新 生成 的 随机 值 是 否 已 经 包含 在 集合 中 。 这 样 一 个 简单 的 检查 能 
基本 确定 RandomGenerator 生 成 值 是 否 为 随机 的 。 


当然 这 个 模块 中 最 重要 的 测试 应 该 在 AccountCaptchaService E, J 
代码 清单 10-11。 


代码 清单 10-11 AccountCaptchaServiceTest.java 


package com. juvenxu. mvnbook. account. captcha; 
import static org. junit.Assert. *; 


import java.io.File; 

import java.io. FPileOutputStream; 
import java.io. OutputStream; 
import java.util.ArrayList; 
import java.util.List; 


import org. junit. Before; 

import org.junit. Test; 

import org. springframework. context. ApplicationContext; 

import org. springframework, context. support.ClassPathXmlApplicationContext; 


public class AccountCaptchaServiceTest 
{ 
private AccountCaptchaService service; 


@ Before 
public void prepare {} 
throws Exception 
{ 
ApplicationContext ctx = new ClassPathXmlApplicationContext | “account- 
captcha. xml" ); 
service = (AccountCaptchaService) ctx.getBean( “accountCaptchaService" ); 
} 


@ Test 

public void testGenerateCaptcha () 
throws Exception 

{ 
String captchaKkey = service. generateCaptchakey (}; 
assertNotNull ( captchakey ); 


byte[] captchalmage = service. generateCaptchalImage ( captchaKey ); 
assertTrue( captchalImage. length > 0); 


File image = new File( "target/" + captchaKey + ".jpg” ); 
OutputStream output = null; 
try 
{ 
output = new FileOutputStream({ image ); 
output.write( captchalmage ); 


finally 
{ 
if ( output != null ) 


{ 
output. close (); 
} 
assertTrue( image. exists() && image. length() > 0 ); 
} 
@ Test 


public void testValidateCaptchaCorrect {) 
throws Exception 


r 
i 
t 


List <String > preDefinedTexts = new ArrayList <String>(}); 
preDefineđTexts.add( "12345" ); 

preDefinedTexts.add( "abcde" ); 

service. setPreDefinedTexts ( preDefinedTexts ) ; 


String captchaKkey = service. generateCaptchakey (); 
service. generateCaptchalImage( captchaKkey ) ; 
assertTrue( service. validateCaptcha( captchaKey, "12345" ) ); 


captchakey = service. generateCaptchaKkey (); 

service. generateCaptchalImage ( captchaKey ); 

assertTrue( service. validateCaptcha( captchaKkey, "abcde" ) ); 
i 
i 


@ Test 
public void testValidateCaptchaIncorrect () 
throws Exception 
{ 
List <String > preDefinedTexts = new ArrayList <String > (); 
preDefinedTexts.add({ "12345" ); 
service. setPreDefinedTexts ( preDefinedTexts ); 


String captchaKey = service. generateCaptchaKey (); 
ser 


ervice. generateCaptchalImage ( captchaKkey }; 
assertFalse( service. validateCaptcha( captchaKey, "67890" ) }; 


该 测试 类 的 prepare O 方法 使 用 @Before 标 注 ， 在 运行 每 个 测试 方 
法 之 前 初始 化 AccountCaptchaService 这 个 bean。 





testGenerateCaptcha O 用 来 测试 验证 码 图 片 的 生成 。 首 先 它 获取 
一 个 验证 码 主键 并 检查 其 非 空 ， 然 后 使 用 该 主键 获得 验证 码 图 片 ， 实 际 


上 是 一 个 字 节 数组 ， 并 检查 该 字 节 数组 的 内 容 非 空 。 紧 接着 该 测试 方法 
在 项 目的 target 目 录 下 创建 一 个 名 为 验证 码 主键 的 jpg 格 式 文件 ， 并 将 
AccountCaptchaService 返 回 的 验证 码 图 片 字 节 数组 内 容 写 入 到 该 jpg 文 件 
中 ， 然 后 再 检查 文件 存在 且 包含 实际 内 容 。 运 行 该 测试 之 后 ， 就 能 在 项 
目的 target 目 录 下 找到 一 个 名 如 dhb022fc.jpg 的 文件 ， 打 开 是 一 个 验证 码 
图 片 ， 如 图 10-1 所 示 。 








图 10-1 AccountCaptchaServiceTest 生 成 的 验证 码 图 片 


testValidateCaptchaCorrect © 用 来 测试 一 个 正确 的 Captcha 验 证 流 
程 。 它 首先 预定 义 了 两 个 Captcha 的 值 放 到 服务 中 ， 然 后 依次 生成 验证 
码 主键 、 验 证 码 图 片 ， 并 且 使 用 主键 和 已 知 的 值 进行 验证 ， 确 保 服 务 正 
常 工作 。 


最 后 的 testValidateCaptchaIncorrect © 方法 测试 当 用 户 反 馈 的 
Captcha 值 错误 时 发 生 的 情景 ， 它 先 预定 义 Captcha 的 值 为 "12345”， 但 最 
后 验证 是 传 入 了 “67890”， 并 检查 validateCaptcha 〈) 方法 返回 的 值 为 


false。 





现在 运行 测试 ， 在 项 目 目录 下 运行 mvn test， 就 会 得 到 如 下 输出 : 


NFO] Scanning for projects... 

[INFO] 

[INFO] 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
INFO] Building Account Captcha 1.0.0 -SNAPSHOT 

[INFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO]... 

INFO] 





[INFO] —--maven-surefire-plugin:2.4.3:test (default-test) @ account-captcha ——— 
[INFO] Surefire report directory: D: \code ch -10 \account-aggregator \account -cap- 


tcha \target \surefire-reports 


Running com. juvenxu.mvnbook. account. captcha. RandomGeneratorTest 


Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.037 sec 
Running com. juvenxu.mvnbook. account. captcha. AccountCaptchaServiceTest 
Tests run: 3, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.016 sec 


Results : 


Tests run: 4, Failures: 0, Errors: 0, Skipped: 0 

WEG ZESSEN es eens ee pare eoiear esa eee gree meres oles ose ener eS apace eae a eer ere se 
[INFO] BUILD SUCCESS 
[INIO] sc Se ee ee er ee ee 


这 个 简单 的 报告 告诉 我 们 ，Maven 运 行 了 两 个 测试 类 ， 其 中 第 一 个 
测试 类 RandomGeneratorTest 包 含 1 个 测试 ， 第 二 个 测试 类 
AccountCaptchaServiceTest 包 含 3 个 测试 ， 所 有 4 个 测试 运行 完毕 后 ， 没 


有 任何 失败 和 错误 ， 也 没有 跳 过 任何 测试 。 


报告 中 的 Failures、Errors、Skipped 信 息 来 源 于 JUnit 测 试 框架 。 
Failures (NO) 表示 要 测试 的 结果 与 预期 值 不 一 致 ， 例 如 测试 代码 期 
望 返回 值 为 tue， 但 实际 为 false; Errors R) 表示 测试 代码 或 产品 代 
码 发 生 了 未 预期 的 错误 ， 例 如 产品 代码 抛 出 了 一 个 空 指针 错误 ， 该 错误 
又 没有 被 测试 代码 捕捉 到 ，Skipped 表 示 那 些 被 标记 为 忽略 的 测试 方 
法 ， 在 JUnit 中 用 户 可 以 使 用 @Ignore 注 解 标记 忽略 测试 方法 。 





10.2 maven-surefire-plugin fii J} 


Maven4s 4 FF ANE PS EZR. Java ttt FA EA AY Ao ik 
框架 为 JUnit Chttp://www.junit.org/) 和 TestNG Chttp://testng.org/) 。 
Maven 所 做 的 只 是 在 构建 执行 到 特定 生命 周期 阶段 的 时 候 ， 通 过 插件 来 
执行 JUnit 或 者 TestNG 的 测试 用 例 。 这 一 插件 就 是 maven-surefire- 
plugin， 可 以 称 之 为 测试 运行 器 (Test Runner) ， 它 能 很 好 地 兼容 JUnit 


3、JUnit 4 以 及 TestNG。 


可 以 回顾 一 下 7.2.3 节 介绍 的 default 生 命 周 期 ， 其 中 的 test 阶 段 被 定义 
为 “使 用 单元 测试 框架 运行 测试 "。 我 们 知道 ， 生 命 周 期 阶段 需要 绑 定 到 
东 个 插件 的 目标 才能 完成 真正 的 工作 ，test 阶 段 正 是 与 naven-surefire- 
plugin 的 test 目 标 相 绑 定 了 ， 这 是 一 个 内 置 的 绑 定 ， 共 体 可 参考 7.4.1 节 。 








在 默认 情况 下 ，maven-surefire-plugin 的 test 目 标 会 自动 执行 测试 源 
码 路 径 《〈 默 认为 srctesUjava/) 下 所 有 符合 一 组 命名 模式 的 测试 类 。 这 组 
模式 为 : 





**/Test* java: 任何 子 目 录 下 所 有 命名 以 Test 开 头 的 Java 类 。 





**/*Test.java: 任何 子 目 录 下 所 有 命名 以 Test 结 尾 的 Java 类 。 





-**/*TestCase.java: 任何 子 目 录 下 所 有 命名 以 TestCase 结 尾 的 Java 


$ 





只 要 将 测试 类 按 上 述 模式 命名 ，Maven 束 能 自动 运行 它们 ， 用 户 也 
就 不 再 需要 定义 测试 集合 〈TestSuite) 来 聚合 测试 用 例 (TestCase) 。 
关于 模式 需要 注意 的 是 ， 以 Tests 结 尾 的 测试 类 是 不 会 得 以 自动 执行 的 。 














当然 ， 如 果 有 需要， 可 以 自己 定义 要 运行 测试 类 的 模式 ， 这 一 点 将 
在 10.5 节 详细 描述 。 此 外 ，maven-surefire-plugin 还 支持 更 高 级 的 TestNG 
测试 集合 xml 文 件 ， 这 一 点 将 在 10.7 节 详 述 


当然 ， 为 了 能 够 运行 测试 ，Maven 需 要 在 项 目 中 引入 测试 框架 的 依 
赖 ， 本 书 已 经 多 次 涉及 了 如 何 添加 JUnit 测 试 范围 依赖 ， 这 里 不 再 效 述 ， 
而 关于 如 何 引 入 TestNG 依 赖 ， 可 参看 10.7 节 。 





10.3” 跳 过 测试 





日 党 工作 中 ， 软 件 开发 人 员 总 有 很 多 理由 来 跳 过 单元 测 
试 , “我 敢 保证 这 次 改动 不 会 导致 任何 汕 试 失败 ”,“ 测 试 运行 太 耗 时 
了 ， 暂 时 跳 过 一 下 ”,， “有 持续 集成 服务 跑 所 有 测试 呢 ， 我 本 地 就 不 执行 
啦 ”。 在 大 部 分 情况 下 ， 这 些 想 法 都 是 不 对 的 ， 任 何 改 动 都 要 交 给 测试 
去 验证 ， 测 试 运行 耗 时 过 长 应 该 考虑 优化 测试 ， 更 不 要 完全 依赖 持续 集 
成 服务 来 报告 错误 ， 测 试 错 误 应 该 尽早 在 尽 小 范围 内 发 现 ， 并 及 时 修 
复 。 





不 管 怎样 ， 我 们 总 会 要 求 Maven 跳 过 测试 ， 这 很 简单 ， 在 命令 行 加 
入 参数 skipTests 就 可 以 了 。 例 如 : 


mvn packageDskipTests 


Maven 输 出 会 告诉 你 它 跳 过 了 测试 : 


[INFO] ---maven-compiler-plugin:2.0.2:testCompile (default-testCompile) @ ac- 
nt-captcha -—— 
[INFO] Compiling 2 source files to D:\\code \ch -10 \account -aggregator \account- 
captcha get \test-classes 
[INFO] 
[INFO] -—--maven-surefire- igin:2.4.3 :te lefa -test) @ ‘ount-captchaea -—— 
INFO] Te kipped 


当然 ， 也 可 以 在 POM 中 配置 maven-surefire-plugin 插 件 来 提供 该 属 
性 ， 如 代码 清单 10-12 所 示 。 但 这 是 不 推荐 的 做 法 ， 如 果 配 置 POM 让 项 
目 长 时 间 地 跳 过 测试 ， 则 还 要 测试 代码 做 什么 呢 ? 


代码 清单 10-12 配置 插件 跳 过 测试 运行 


<plugin> 
<groupId >org. apache. maven. plugins < /groupId > 


<artifactId >maven-surefire-plugin < /artifactId > 





<skipTests >true < /skipTests > 
< / configuration > 
< / plugin > 


有 时 候 用 户 不 仅仅 想 跳 过 测试 运行 ， 还 想 临 时 性 地 跳 过 测试 代码 的 
编译 ，Maven 也 允许 你 这 么 做 ,但 记 住 这 是 不 推荐 的 : 


S mvn package Dmaven. test. skip =true 


这 时 Maven 的 输出 如 下 : 


[INFO] —-—maven-compiler-plugin:2.0.2:testCompile (default-testCompile) 


DD 
w 
| 


count-captcha -—- 
[INFO] Not compiling test sources 


[INFO] Tests are skipped. 


参数 maven.test.skip 同 时 控制 Y maven-compiler-plugin #llmaven- 
surefire-plugin 两 个 插件 的 行为 ， 测 试 代码 编译 跳 过 了 ， 测 试 运行 也 跳 过 
J 


对 应 于 命令 行 参数 maven.test.skip 的 POM 配 置 如 代码 清单 10-13 所 
示 ， 但 这 种 方法 也 是 不 推荐 使 用 的 。 


代码 清单 10-13 ”配置 插件 跳 过 测试 编译 和 运行 


<plugin > 
<groupId >org. apache. maven. plugins </groupId > 
<artifactId >maven-compiler-plugin < /artifactId > 
<version >2.1</version > 
<configuration > 
< skip >true</skip> 
< / configuration > 
</plugin> 
<plugin > 
<groupid >org. apache. maven. plugins < /groupid > 
<artifactId >maven-surefire-plugin < /artifactId > 
<version >2.5</version > 
<configuration > 
<skip >true < /skip > 
< / configuration > 
</plugin > 


实际 上 maven-compiler-plugin 的 testCompile 目 标 和 maven-surefire- 
plugin 的 test 目 标 都 提供 了 一 个 参数 skip 用 来 跳 过 测试 编译 和 测试 运行 ， 
而 这 个 参数 对 应 的 命令 行 表 达 式 为 maven .test.skip。 


10.4 动态 指定 要 运行 的 测试 用 例 





反复 运行 单个 测试 用 例 是 日 营 开 发 中 很 常见 的 行为 。 例 如 ， 项 目 代 
码 中 有 一 个 失败 的 测试 用 例 ， 开 发 人 员 台 会 想 要 再 次 运行 这 个 测试 以 获 
得 详细 的 错误 报告 ， 在 修复 该 测试 的 过 程 中 ， 开 发 人 员 也 会 反复 运行 
它 ， 以 确认 修复 代码 是 正确 的 。 如 果 仅 仅 为 了 一 个 失败 的 测试 用 例 而 反 
复 运 行 所 有 测试 ， 未 免 太 浪费 时 间 了 ， 妆 项 目 中 测试 的 数目 比较 大 的 时 
候 ， 这 种 浪费 尤为 明显 。 

maven-surefire-plugin 提 供 了 一 个 test 参 数 让 Maven 用 户 能 够 在 命令 行 


指定 要 运行 的 测试 用 例 。 例 如 ， 如 果 只 想 运 行 account-captcha 的 


RandomGeneratorTest， 就 可 以 使 用 如 下 命令 : 
这 里 test 参 数 的 值 是 测试 用 例 的 类 名 ， 这 行 命令 的 效果 就 是 只 有 
RandomGeneratorTest 这 一 个 测试 类 得 到 运行 。 
maven-surefire-plugin 了 的 test 参 数 还 文 持 高 级 一 些 的 赋值 方式 ， 能 让 
用 户 更 灵活 地 指定 需要 运行 的 测试 用 例 。 例 如 : 


S mvn test Dtest = Random * Test 





星 号 可 以 匹配 零 个 或 多 个 字符 ， 上 述 命令 会 运行 项 目 中 所 有 类 名 以 


Random 开 头 、Test 结 尾 的 测试 类 。 





除了 星 写 匹配 ， 还 可 以 使 用 逗 写 指定 多 个 测试 用 例 : 


$s mvn test Dtest =RandomGeneratorTest ,AccountCaptchaServicetest 
该 命令 的 test 参 数值 是 两 个 测试 类 名 ， 它 们 之 间 用 逗号 隔 开 ， 其 效 


果 束 是 告诉 Maven 只 运行 这 两 个 测试 类 。 
当然 ， 也 可 以 结合 使 用 星 号 和 未 号 。 例 如 : 
$ mvn test Dtest = Random » Test ,AccountCaptchaServiceTest 


需要 注意 的 是 ， 上 述 几 种 从 命令 行动 态 指定 测试 类 的 方法 都 应 该 只 
古 临时 使 用 ， 如 果 长 时 间 只 运行 项 目的 条 几 个 测试 ， 那 么 测试 就 会 慢 慢 
失去 其 本 来 的 意义 。 





test 参 数 的 值 必须 匹配 一 个 或 者 多 个 测试 类 ， 如 果 maven-surefire- 
plugin 找 不 到 任何 匹配 的 测试 类 ， 就 会 报错 并 导致 构建 失败 。 例 如 下 面 
的 命令 没有 [匹配 任何 测试 类 : 


这 样 的 命令 会 导致 构建 失败 ， 输 出 如 下 : 


[INFO] ---maven-surefire-plugin:2.4.3:test (default-test) @ account-captcha ——- 


[INFO] Surefire report directory: D: \code \ch -10 \account-aggregator \account-cap- 
tcha \target \surefire-reports 


lere are no tests to ru 
Result 
Tests run: 0, Failures: 0, Errors: 0, Skipped: 0 


INFO] BUILD FAILURE 

INEDI sem ee er ee ee en 
[INFO] Total time: 1.747s 

[INFO] Finished at: Sun Mar 28 17:00:27 CST 2010 

[INFO] Final Memory: 2M/5M 

PERO] ass 
[ERROR] Failed to execute goal org. apache. maven. plugins :maven-surefire-plugin: 
Be 3:test (def ault-test) on project account- captcha: No tests were executed! 

et-DfaillfNoTests = false to ignore this error.) - > [Help 1] 
neal 
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch. 





根据 错误 提示 可 以 加 上 -DfailIfNoTests=false， 告 诉 maven-surefire- 
plugin 即 使 没有 任何 测试 也 不 要 报错 : 


vn test-DtestDfaillfNoTests = false 


Ut 
一 
pa 





这 样 构建 就 能 顺利 执行 完毕 了 。 可 以 发 现 ， 实 际 上 使 用 命令 行 参 
数 -Dtest-DfailIfNoTests=false 是 另外 一 种 跳 过 测试 的 方法 。 


我 们 看 到 ， 使 用 test 参 数 用 户 可 以 从 命令 行 灵活 地 指定 要 运行 的 测 
试 类 。 可 惜 的 是 ，maven-surefire-plugin 并 没有 提供 任何 参数 支持 用 户 从 
命令 行 哟 过 指定 的 测试 类 ， 好 在 用 户 可 以 通过 在 POM 中 配置 maven- 
surefire-plugin 排 除 特 定 的 测试 类 。 


10.5 ”包含 与 排除 测试 用 例 





10.2 节 介绍 了 一 组 命名 模式 ， 符 合 这 一 组 模式 的 测试 类 将 会 自动 执 
行 。Maven 提 倡 约定 优 于 配置 原则 ， 因 此 用 户 应 该 尽量 遵守 这 一 组 模式 
来 为 测试 类 命名 。 即 便 如 此 ，maven-surefire-plugin 还 是 允许 用 户 通过 额 
外 的 配置 来 自 定 义 包 含 一 些 其 他 测试 类 ， 或 者 排除 一 些 符 合 默 认命 名 模 
式 的 测试 类 。 








例如 ， 由 于 历史 原因 ， 有 些 项 目 所 有 测试 类 名 称 都 以 Tests 结 尾 ， 这 
样 的 名 字 不 符合 默认 的 3 种 模式 ， 因 此 不 会 被 自动 运行 ， 用 户 可 以 通过 
代码 清单 10-14 所 示 的 配置 让 Maven 自 动 运行 这 些 测 试 。 


代码 清单 10-14 ”自动 运行 以 Tests 结 尾 的 测试 类 


<groupId >org. apache. maven. plugins < /groupIid > 
<artifactiId >maven-surefire-plugin < /artifactId> 
<version >2.5 </version > 


<include > ** / * Tests. java < /include > 
/ includes > 
< /configuration > 
</plugin > 


上 述 代码 清单 中 使 用 了 **/*Tests.java 来 匹配 所 有 以 Tests 结 尾 的 Java 
类 ， 两 个 星 号 ** 用 来 匹配 任意 路 径 ， 一 个 星 号 * 匹 配 除 路 径 风 格 符 外 的 0 


个 或 者 多 个 字符 。 


类 似 地 ， 也 可 以 使 用 excludes 元 素 排除 一 些 符合 默认 命名 模式 的 测 
试 类 ， 如 代码 清单 10-15 所 示 。 


代码 清单 10-15 ”排除 运行 测试 类 


<plugin> 
<groupld >org.apache.maven.plugins < /groupId > 


<artifactId >ma\ surefire-plugin < /artifactId > 





<version >2.5</version> 
<configuration > 
<excludes > 
<exclude > ** / * ServiceTest. java < /exclude > 
<exclude > ** /TempDaoTest. java < /exclude > 
< /excludes > 
< f/configuration > 
< / plugin > 


上 述 代码 清单 排除 了 所 有 以 ServiceTest 结 尾 的 测试 类 ， 以 及 一 个 名 
为 TempDaoTest 的 测试 类 。 它 们 都 符合 默认 的 命名 模式 **/*Test.java， 不 


过 ， 有 了 excludes 配 置 后 ，maven-surefire-plugin 将 不 再 自动 运行 它们 。 


10.6 ”测试 报告 


除了 命令 行 输 出 ，Maven 用 户 可 以 使 用 maven-surefire-plugin 等 插件 
以 文件 的 形式 生成 更 丰富 的 测试 报告 。 





10.6.1 基本 的 测试 报告 


默认 情况 下 ，maven-surefire-plugin 会 在 项 目的 target/surefire-reports 
目录 下 生成 两 种 格式 的 错误 报告 : 





.简单 文本 格式 
与 JUnit 兼 容 的 XML 格式 


例如 ， 运 行 10.1.3 节 代码 清单 10-10 中 的 RandomGeneratorTest 后 会 得 
到 一 个 名 为 
com.juvenxu.mvnbook.account.captcha.RandomGeneratorTest.txt 的 简单 文 
本 测试 报告 和 一 个 名 为 TEST- 
com.juvenxu.mvnbook.account.captcha.RandomGeneratorTest.xml 的 XML 
测试 报告 。 前 者 的 内 容 十 分 人 简单: 


Test set: com. juvenxu. mvnbook. account. captcha. RandomGeneratorTest 


Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.029 sec 








这 样 的 报告 对 于 获得 信息 足够 了 ，XML 格 式 的 测试 报告 主要 是 为 
了 支持 工具 的 解析 ， 如 Eclipse 的 JUnit 插 件 可 以 直接 打开 这 样 的 报告 ， 如 
图 10-2 所 示 。 


Runs: 1/1 Errors: 0 Bi Failures: 0 





bic) Comjuvenxu.mvnbook.account.captcha.RandomGeneratorTest (0.022 s) 
=) testGetRandomString (0.005 5) 





图 10-2 ”使 用 Eclipse JUnit 插 件 打开 成 功 的 XML 测试 报告 


由 于 这 种 XML 格式 已 经 成 为 了 Java 单 元 测试 报告 的 事实 标准 ， 一 些 
其 他 工具 也 能 使 用 它们 。 例 如 ， 持 续集 成 服务 器 Hudson 惑 能 使 用 这 样 的 
文件 提供 持续 集成 的 测试 报告 。 


以 上 展示 了 一 些 运 行 正确 的 测试 报告 ， 实 际 上 ， 错 误 的 报告 更 具 价 


值 。 我 们 可 以 修改 10.1.3 节 代码 清单 10-11 中 的 
AccountCaptchaServiceTest 计 一 个 测试 失败 ， 这 时 得 到 的 简单 文本 报告 


会 是 这 样 : 


Test set: com. juvenxu.mvnbook. account. captcha. AccountCaptchaServiceTest 


Tests run: 3, Failures: 1, Errors: 0, Skipped: 0, Time elapsed: 0.932 sec < < < 


FAILURE! 
testValidateCaptchaCorrect (com. juvenxu.mvnbook. account.captcha. AccountCapt- 


chaServiceTest) Time elapsed: 0.047 sec < < < FAILURE! 


java.lang.AssertionError: 

at org. junit.Assert. fail (Assert. java:91) 

at org. junit.Assert.assertTrue (Assert. java:43) 

at org. junit.Assert.assertTrue (Assert. java:54) 

at com. juvenxu.mvnbook. account. captcha. AccountCaptchaServiceTest.testVal- 
idateCaptchaCorrect (AccountCaptchaServiceTest. java:66) 


报告 说 明了 哪个 测试 方法 失败 、 哪 个 断言 失败 以 及 有 具体 的 堆栈 信 


轧 ， 用 户 可 以 据 此 快速 地 寻找 失败 原因 。 该 测试 的 XML 格式 报告 用 
Eclipse JUnit 插 件 打开 ， 如 图 10-3 所 示 。 


Runs: 3/3 B Errors: 0 B Failures: 1 


Be) Com.juvenxu.mvnbook.account.captcha.AccountCaptchaServiceTest (0.929 s 
点 | testGenerateCaptcha (0.838 s) 
上 明 testValidateCaptchaCorrect (0.047 s) 
de) testValidateCaptchalncorrect (0.038 s 


= failure Trace 





49 java.lang.AssertionError: 


at com.juvenxu.mynbook.account.captcha.AccountCaptchaServiceTest.testValidateCa 
at org.apache.maven.surefire.junit4 JUnit4TestSet.execute(JUnit4TestSet.java:62) 

at org.apache,maven.surefire.suite AbstractDirectoryTestSulte.executeTestSet(Abstra 
at org.apache.maven.surefire.suite AbstractDirectoryTestSuite.execute(AbstractDire 
at org.apache.maven.surefire.Surefire.run(Surefire java:177) 

at org.apache.maven.surefire.booter.SurefireBooter.runSuitesInProcess(SurefireBoo 
at org.apache.maven.surefire.booter.SurefireBooter.main(SurefireBooter.java:1009) 


110-3 ”使 用 Eclipse JUnit 插 件 打 开 失 败 的 XML 测试 报告 





从 图 10-3 所 示 的 堆栈 信息 中 可 以 看 到 ， 该 测试 是 由 maven-surefire- 
plugin 发 起 的 。 


10.6.2 ”测试 覆盖 率 报 告 











测试 履 盖 率 是 衡量 项 目 代 码 质 量 的 一 个 重要 的 参考 指标 。Cobertura 
是 一 个 优秀 的 开源 测试 覆盖 率 统计 工具 《〈 详 见 
http://cobertura.sourceforge.net/) ，]Maven 通 过 cobertura-maven-plugin 与 
之 集成 ， 用 户 可 以 使 用 简单 的 命令 为 Maven 项 目 生成 测试 牙 盖 率 报告 。 
例如 ， 可 以 在 account-captcha 目 录 下 运行 如 下 命令 生成 报告 : 





S mvn cobertura:cobertura 


接着 打开 项 目 目录 target/site/cobertura/ 下 的 index.html 文 件 ， 就 能 看 
到 如 图 10-4 所 示 的 测试 履 善 率 报告 。 


Coverage Report - com.juvenxu.mvnbook.account.captcha 


Package # Classes Line Coverage Branch Coverage Complexity 
com.juvenxu.mvnbook.account.captcha = 78% 36/46 75% | 3/12 E 1.333 





Classes in this Package Line Coverage Branch Coverage Complexity 
AccountCaptchaException 





AccountCaptchaService 





AccountCaptchaServiceimp! 








RandomGenerator 





Report generated by Cobertura 1.9 on 10-3-29 £+10:02. 


图 10-4 “Cobertura 测 试 履 羡 率 报告 


单 击 共 体 的 类 ， 还 能 看 到 精确 到 行 的 履 盖 率 报 告 ， 如 图 10-5 所 示 。 


public bytel] generateCaptchalmage( String captchaKer ) 
throws AccountCaptchaException 

{ 
String text = captchaMap. get ( captchaKey ) 


BufferedImage image = producer. cresteImage{ text ) 
ByteArrarOutputStream out = mew ErteArrarOutputStreas() : 


try 


[ 


Imagel0. write( image, "jpe", out ) 





图 10-5 ”具体 到 代码 行 的 Cobertura 测 试 履 盖 率 报告 


10.7 运行 TestNG 测 试 


TestNG 是 Java 社 区 中 除 JUnit 之 外 男 一 个 流行 的 单元 测试 框架 。NG 





是 Next Generation 的 缩写 ， 译 为 “下 一 代 ”。TestNG 在 JUnit 的 基础 上 增加 
了 很 多 特性 ， 读 者 可 以 访问 其 站 点 http://testng.org/ 获 取 更 多 信息 。 值 得 
一 提 的 是 ， Next Generation Java Testing) (Java 测 试 新 技术 ， 中 文 版 
己 由 机 械 工业 出 版 社 引进 出 版 ， 书 号 为 978-7-111-24550-6) 一 书 专门 介 
绍 TestNG 和 相关 测试 技巧 。 


使 用 Maven 运 行 TestNG 十 分 方便 。 以 10.1.3 节 中 的 account-captcha 测 
试 代码 为 例 ， 首 先 需 要 删除 POM 中 的 JUnit 依 赖 ， 加 入 TestrNG 依 赖 ， 见 
代码 清单 10-16。 


代码 清单 10-16 ”加 入 TestrNG 依 赖 


< dependency > 
<groupId >org.testng < /groupid > 
<artifactId >testng </artifactId > 
version >5. ‘version 
scope est scope 
/depende 


与 JUnit 类 似 ，TestNG 的 依赖 范围 应 为 test。 此 外 ，TestNG 使 用 
classifier jdk15 和 jdk14 为 不 同 的 Java 平 台 提 供 支 持 。 


下 一 步 需要 将 对 JUnit 的 类 库 引 用 更 改 成 对 TestNG 的 类 库 引 用 。 表 


10-1 给 出 了 和 常用 类 库 的 对 应 关系 。 





表 10-1 JUnit 和 TestNG 的 常用 类 库 对 应 关系 


JUnit 类 TestNG 类 作 H 

















org. junit. Test org. testng. annotations. Test 标注 方法 为 测试 方法 

org. junit. Assert org. testng. Assert 念 查 测试 结果 

org. junit. Before org. testng. annotations. BeforeMethod 标注 方法 在 每 个 测试 方法 之 前 运行 
org. junit. After org. testng. annotations. AfterMethod 标注 方法 在 每 个 测试 方法 之 后 运行 
org, junit. BeforeClass org. testng. annotations. BeforeClass 标注 方法 在 所 有 测试 方法 之 前 运行 
org. junit. AfterClass org. testng. annotations. AfterClass 标注 方法 在 所 有 测试 方法 之 后 运行 


将 JUnit 的 类 库 引 用 改 成 TestNG 之 后 ， 在 命令 行 输入 mvn test, 
Maven 束 会 自动 运行 那些 符合 命名 模式 的 测试 类 。 这 一 点 与 运行 JUnit 测 
试 没有 区 别 。 








TestNG 人 允许 用 户 使 用 一 个 名 为 testng.xml 的 文件 来 配置 想 要 运行 的 
测试 集合 。 例 如 ， 可 以 在 account-captcha 的 项 目 根 目录 下 创建 一 个 
testng.xml 文 件 ， 配 置 只 运行 RandomGeneratorTest， 如 代码 清单 10-17 所 


7B 
代码 清单 10-17 TestNG 的 testng.xml 


<?xml version = "1.0" encoding = "UTF 一 8"? > 


< suite name = "Suitel" verbose = "1"> 


<test name = "Regressioni " 


me = "com. juvenxu.mvnbook. account . captcha. RandomGeneratorTest"/> 





同时 再 配置 maven-surefire-plugin 使 用 该 testng.xml， 如 代码 清单 10- 
18 所 示 。 


代码 清单 10-18 配置 maven-surefire-plugin 使 用 testng.xml 


<groupId >org. apache. maven. plugins < /groupId > 


<artifactIad >maven-surefire-plugin < /artifactId > 


<version >2.5 </version > 
<configuration > 
<suiteXmlFiles > 


<suiteXmlFile >testng. xml < /suiteXmlFile > 
< /suiteXmlFiles > 
< / configuration > 
</plugin > 


TestNG 较 JUnit 的 一 大 优势 在 于 它 文 持 测 试 组 的 概念 ， 如 下 的 注解 
会 将 测试 方法 加 入 到 两 个 测试 组 util 和 medium 中 : 


@ Test ( groups = { "util", "medium" } ) 


由 于 用 户 可 以 自由 地 标注 方法 所 属 的 测试 组 ， 因 此 这 种 机 制 能 让 用 
户 在 方法 级 别 对 测试 进行 归 类 。 这 一 点 JUnit 无 法 做 到 ， 它 只 能 实现 类 级 
别 的 测试 归 类 。 





Maven 用 户 可 以 使 用 代码 清单 10-19 所 示 的 配置 运行 一 个 或 者 多 个 
TestNG 测 试 组 。 


代码 清单 10-19 配置 maven-surefire-plugin 运 行 TestNG 测 试 组 


<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactiId >maven-surefire-plugin < /artifactId > 
<version >2.5</version> 
<configuration > 
<groups >util,medium< /groups > 
</ configuration > 
</plugin > 


由 于 篇 幅 所 限 ， 这 里 不 再 介绍 更 多 TestNG 的 测试 技术 ， 感 兴趣 的 读 
者 请 访问 TestNG 站 点 。 


10.8 重用 测试 代码 


优秀 的 程序 员 会 像 对 竺 产品 代码 一 样 细心 维护 测试 代码 ， 无 其 是 那 
些 供 具体 测试 类 继承 的 抽象 类 ， 它 们 能 够 简化 测试 代码 的 编写 。 还 有 一 
些 根据 具体 项 目 环境 对 测试 框 娘 的 扩展 ， 也 会 被 大 范围 地 重用 。 








在 命令 行 运行 mvn package 的 时 候 ，Maven 会 将 项 目的 主 代码 及 资源 
文件 打包 ， 将 其 安装 或 部 署 到 仓库 之 后 ， 这 些 代 码 就 能 为 他 人 使 用 ， 从 
而 实现 Maven 项 目 级 别 的 重用 。 默 认 的 打包 行为 是 不 会 包含 测试 代码 
的 ， 因 此 在 使 用 外 部 依赖 的 时 候 ， 其 构件 一 般 都 不 会 包含 测试 代码 。 








然后 ， 在 项 目 内 部 重用 某 个 模块 的 测试 代码 是 很 常见 的 需求 ， 可 能 
某 个 底层 模块 的 测试 代码 中 包含 了 一 些 常用 的 测试 工具 类 ， 或 者 一 些 高 
质量 的 测试 基 类 供 继承 。 这 个 时 候 Maven 用 户 就 需要 通过 配置 maven-jar- 
plugin 将 测试 类 打包 ， 如 代码 清单 10-20 所 示 。 


代码 清单 10-20 打包 测试 代码 


<plugin> 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-jar-plugin < /artifactId> 
<version >2.2 </version > 
<executions > 
<execution > 
<goals > 
<goal >test-jar < /goal > 
/goals > 
</execution > 
< / executions > 
</plugin> 


maven-jar-plugin 有 两 个 目标 ， 分 别 是 jar 和 test-jar， 前 者 通过 Maven 
的 内 置 绑 定 在 default 生 命 周 期 的 package 阶 段 运 行 ， 其 行为 就 是 对 项 目 主 
代码 进行 打包 ， 而 后 者 并 没有 内 置 绑 定 ， 因 此 上 述 的 插件 配置 显 式 声明 
该 目标 来 打包 测试 代码 。 通 过 查询 该 插件 的 具体 信息 可 以 了 解 到 ，test- 
jar 的 默认 绑 定 生命 周期 阶段 为 package， 因 此 当 运 行 mvn clean package 后 
就 会 看 到 如 下 输出 : 





[INFO] ---maven-jar-plugin:2.2 nes ee ult-jar) @ account-captcha 一 一 一 

[INFO] Building jar: D: \code\ch-10 ount-aggregator \account-captcha \target \ 
account-captcha -1.0.0 - SNAPSHOT. a 

INFO] 

[INFO] ---maven-jar-plugin:2.2:test-jar (default) @ account-captcha -—— 

[INFO] Building jar: D: \code `ch - ae" \account-aggregator \account-captcha \target \ 
account-captcha -1.0.0 -SNAPSHOT —tests. jar 





maven-jar-plugin 的 两 个 目标 都 得 以 执行 ， 分 别 打包 了 项 目 主 代 码 和 
测试 代码 。 


现在 ， 残 可 以 通过 依赖 声明 使 用 这 样 的 测试 包 构件 了 ， 如 代码 清单 


10-21 所 示 。 


代码 清单 10-21 依赖 测试 包 构件 


< dependency > 
<groupId > Com, juvenxu. mvnbook, account < /groupId > 
<artifactId >account-captcha < /artifactId> 
<version >1.0.0 -SNAPSHOT <version> 
<type >test-jar < /type > 
< scope >test < /scope > 

< /dependency > 


上 述 依赖 声明 中 有 一 个 特殊 的 元 又 type， 上 所 有 测试 包 构 件 都 使 用 特 
殊 的 test-jar 打 包 类 型 。 需 要 注意 的 是 ， 这 一 类 型 的 依赖 同样 都 使 用 test 依 


10.9 ”小 结 





本 章 的 主题 是 Maven 与 测试 的 集成 ， 不 过 在 讲述 具体 的 测试 技巧 之 
前 先 实现 了 背景 案例 的 account-captcha 模 块 ， 这 一 模块 的 测试 代码 也 成 
了 本 章 其 他 内 容 良 好 的 素材 。maven-surefire-plugin 是 Maven 背 后 真正 执 
行 测试 的 插件 ， 它 有 一 组 默认 的 文件 名 模式 来 匹配 并 上 自动 运行 调试 类 。 
用 户 还 可 以 使 用 该 插件 来 跳 过 测试 、 动 态 执行 测试 类 、 包 含 或 排除 测试 
等 。maven-surefire-plugin 能 生成 基本 的 测试 报告 ， 除 此 之 外 还 能 使 用 


cobertura-maven-plugin 生 成 测试 覆盖 率 报 告 。 





除了 主流 的 JUnit 之 外 ， 本 章 还 讲述 了 如 何 与 TestNG 集 成 ， 最 后 介 
绍 了 如 何 重用 测试 代码 。 


第 11 章 ”使 用 Hudson 进 行 持续 集成 
内 容 
-持续 集成 的 作用 、 过 程 和 优势 
.Hudson 简 介 
安装 Hudson 
.准备 Subversion 仓 库 
.Hudson 的 基本 系统 设置 
.创建 Hudson 任 务 
监视 Hudson 任 务 状态 
-Hudson H P 
邮件 反馈 
Hudson 工作 目录 
:小结 


作为 最 核心 的 敏捷 实践 之 一 一 一 持续 集成 (Continuous 


Integration) 越 来 越 受 到 广大 开发 人 员 的 喜爱 和 推演。 借助 前 文 讲 述 的 
Maven 所 实现 的 自动 化 构建 正 是 持续 集成 的 一 个 必要 前 提 ， 持 续集 成 还 
要 求 开 发 人 员 使 用 版 本 控制 工具 和 持续 集成 服务 器 。 例 如 Subversion 就 
是 当前 最 流行 的 版 本 控制 工具 ， 而 Hudson 则 是 最 流行 的 开源 持续 集成 服 
务 器 软件 。 本 章 将 简要 介绍 持续 集成 的 概念 和 Subversion 的 基本 使 用 ， 

主要 关注 如 何 使 用 Hudson， 尤 其 是 如 何 结合 Maven 与 Hudson 持 续集 成 我 
们 的 项 目 。 








11.1 持续 集成 的 作用 、 过 程 和 优势 











简单 地 次 ， 持 续集 成 融 是 快速 且 高 频率 地 目 动 构建 项 目的 所 有 源 
码 ， 并 为 项 目 成 员 提 供 丰 富 的 反馈 信息 。 这 句 话 有 很 多 关键 的 词 : 








TREE: 集成 的 速度 要 尽 可 能 地 快 ， 开 发 人 员 不 希望 目 己 的 代码 提 
交 半 天 之 后 才 得 到 反馈 。 

局 频率 频率 越 高 越 好 ， 例 如 每 隔 一 小 时 就 是 个 不 错 的 选择 ， 这 
样 问 题 才能 尽早 地 被 反映 出 来 。 

` 目 动 : 持续 集成 应 该 是 自动 触发 并 执行 的 ， 不 应 该 有 手工 参与 。 

构建 包括 编译 、 测 试 、 审 但 、 打 包 、 部 署 等 工作 。 

:所 有 源码 : 所 有 团队 成 员 提 交 到 代码 库 里 的 最 新 的 源 代码 。 


反馈: 持续 集成 应 该 通过 各 种 快捷 的 方式 告诉 团队 成 员 最 新 的 集 
成 状态 ， 妆 集成 失败 的 时 候 ， 反 人 馈 报告 应 该 尽 可 能 地 反映 失败 的 具体 细 


HW 


de 
一 个 典型 的 持续 集成 场景 是 这 样 的 : 开发 人 员 对 代码 做 了 一 些 修 


改 ， 在 本 地 运行 构建 并 确认 无 误 之 后 ， 将 更 改 提 交 到 代码 库 。 具 有 高 配 
置 硬件 的 持续 集成 服务 器 每 隔 30 分 钟 得 询 代 码 库 一 次 ， 发 现 更 新 之 后 ， 








签 出 所 有 最 新 的 源 代 码 ， 然 后 调用 目 动 化 构建 工具 〈 如 Maven) 构建 项 
目 ， 该 过 程 包 括 编译 、 测 试 、 审 查 、 打 包 和 部 署 等 。 然 而 不 幸 的 是 ， 另 
外 一 名 开 及 人 员 在 这 一 时 间 段 也 提交 了 代码 更 改 ， 两 处 更 改 导 致 了 某 些 
测试 的 失败 ， 持 续集 成 服务 器 基于 这 些 失败 的 训 试 创建 一 个 报告 ， 并 自 
动 发 送 给 相关 开发 人 员 。 开 发 人 员 收 到 报告 后 ， 立 即 独 手 调查 原因 ， 并 
尽快 修复 。 














图 11-1 形 象 地 展示 了 整个 持续 集成 的 过 程 。 


通过 图 11-1 可 知 ， 当 持续 集成 服务 露 构建 项 目 成 功 后 ， 还 可 以 目 动 
将 项 目 构件 部 车 到 Nexus 私 服 中 。 


一 次 完整 的 集成 往往 会 包括 以 下 6 个 步骤 : 


1) 持续 编译 : 所 有 正式 的 源 代 码 都 应 该 提交 到 源码 控制 系统 中 
(如 Subversion ) ， 持 续集 成 服务 器 按 一 定 频 率 检查 源码 控制 系统 ， 如 
果 有 新 的 代码 ， 就 触发 一 次 集成 ， 旧 的 已 编译 的 字 节 人 码 应 当 全 部 清除 ， 
然后 服务 器 编译 所 有 最 新 的 源码 。 











2) 持续 数据 库 集成 : 在 很 多 项 目 中 ， 源 代码 不 仅仅 指 Java 代 码 ， 
还 包括 了 数据 库 SQL 脚 本 ， 如 果 单 独 管 理 它 们 ， 很 容易 造成 与 项 目 其 他 
代码 的 不 一 致 ， 并 造成 混乱 。 持 续集 成 也 应 该 包括 数据 库 的 集成 ， 每 次 
发 现 新 的 SQL 脚本 ， 融 应 该 清理 集成 环境 的 数据 库 ， 重 新 创建 表 结 构 ， 
并 填 入 预备 的 数据 。 这 样 就 能 随时 发 现 脚本 的 错误 ， 此 外 ， 基 于 这 些 脚 





本 的 测试 还 能 进一步 发 现 其 他 相关 的 问题 。 


a 3 = 一 部 署 
MS A 4- 私服 
源码 控制 服务 器 持续 集成 服务 器 /1 aon 


开发 者 (Subversion) (Hudson) J 
构建 





图 11-1 持续 集成 流程 


3) 持续 测试 : 有 了 JUnit 之 类 的 框架 ， 自 动 化 测试 束 成 了 可 能 。 编 
写 优 民 的 单元 测试 并 不 容易 ， 好 的 单元 测试 必须 是 自动 化 的 、 可 重复 执 
行 的 、 不 依赖 于 环境 的 ， 并 且 能 够 目 我 检查 的 。 除 了 单元 测试 ， 有 些 项 
目 还 会 包含 一 些 依赖 外 部 环境 的 集成 测试 。 所 有 这 些 测试 都 应 该 在 每 次 
集成 的 时 候 运 行 ， 并 且 在 发 生 问 题 的 时 候 能 产生 具体 报告 。 








4) 持续 审查 :诸如 Checkstyle 和 PMD 之 类 的 工具 能 够 帮 我 们 发 现代 
码 中 的 坏 味道 (Bad Smell) ， 持 续集 成 可 以 使 用 这 些 工具 来 生成 各 类 报 
告 ， 如 测试 履 盖 率 报告 、Checkstyle 报 告 、PMD 报 告 等 。 这 些 报告 的 生 
成 频率 可 以 低 一 些 ， 如 每 日 生成 一 次 ， 当 审查 发 现 问题 的 时 候 ， 可 以 给 


开发 人 员 反 馈 和 警告 信息 。 





5) 持续 部 着 : 有 些 错误 只 有 在 部 署 后 才能 被 发 现 ， 它 们 往往 是 具 
体 容 器 或 者 环境 相关 的 ， 目 动 化 部 效能 够 帮助 我 们 尽快 发 现 这 类 问题 。 











6) 持续 反馈 .持续 集成 的 最 后 一 步 的 反馈 ， 通常 是 一 封 电子 邮 
件 。 在 重要 的 时 候 将 正确 的 信息 发 送 给 正确 的 人 。 如 果 开 发 者 一 直 受 到 
与 目 己 无 关 的 持续 集成 报告 ， 他 慢 慢 地 区 会 名 略 这 些 报告 。 基 本 的 规则 
是 : 将 集成 失败 报告 发 送 给 这 次 集成 相关 的 代码 提交 者 ， 项 目 经 理应 该 
收 到 所 有 失败 报告 。 








持续 集成 需要 引入 额外 的 硬件 设置 ， 特 别 是 对 于 持续 集成 服务 器 来 
说 ， 性 能 越 咒 ， 集 成 的 速度 束 越 快 ， 反 馈 的 速度 也 就 越 快 。 持 续集 成 还 
要 求 开发 者 使 用 各 种 工具 ， 如 源码 控制 工具 、 自 动 化 构建 工具 、 自 动 化 
测试 工具 、 持 续集 成 软件 等 。 这 一 切 无 疑 都 增加 了 开发 人 员 的 负担 ， 然 
而 学 习 并 适应 这 些 工具 及 流程 是 完全 值得 的 ， 因 为 持续 集成 有 着 很 多 好 
处 : 














尽早 暴露 问题 : 越 早 地 暴露 问题 ， 修 复 问 题 代 码 的 成 本 就 越 低 。 
持续 集成 高 频率 地 编译 、 测 试 、 审 查 、 部 普 项 目 代 码 ， 能 够 快速 地 发 现 
问题 并 及 时 反馈 。 





-减少 重复 操作 : 持续 集成 是 完全 自动 化 的 ， 这 就 避免 了 大 量 重 复 
的 手工 劳动 ， 开 及 人 员 不 再 需要 手动 地 去 签 出 源码 ， 一 步 步 地 编译 、 测 
试 、 审 查 、 部 署 。 


:简化 项 目 发 布 : 每 日 高 频率 的 集成 保证 了 项 目 随时 都 是 可 以 部 嗜 
行 的 ， 如 果 没 有 持续 集成 ， 项 目 发 布 之 前 将 不 得 不 手动 地 集成 ， 然 后 





运 
He 


化 大 量 精力 修复 集成 问题 。 





建 并 团队 信心 : 一 个 优良 的 持续 集成 环境 能 让 团队 随时 对 项 目的 
状态 保持 信心 ， 因 为 项 目的 大 部 分 问题 区 域 已 经 由 持续 集成 环境 窗 畜 


Ts 





既然 持续 集成 有 那么 多 优点 ， 现 在 让 我 们 开始 动手 架设 自己 的 持续 
集成 环境 吧 ! 


11.2 ”Hudson 简介 





优秀 的 持续 集成 工具 有 很 多 ， 如 老牌 的 开源 工具 CruiseControl、 商 
业 的 Bamboo 和 TeamCity 等 。 本 书 只 介绍 Hudson， 因 为 它 是 目前 最 流行 
的 开源 持续 集成 工具 。 该 项 目 过 去 一 直 托 管 在 java.net 社 区 ， 不 过 现在 已 
经 迁移 到 http://hudson-ci.org/。Hudson 主 要 是 由 Kohsuke Kawaguchi 开 发 
和 维护 的 ，Kohsuke Kawaguchi 自 2001 年 就 已 经 加 入 Sun 公 司 ( 当 然 ， 现 
在 已 经 是 Oracle 了 ) ， 不 过 当 笔 者 写 下 这 些 文字 的 时 候 ， 他 刚 宣 布 离 开 
Sun/Oracle 并 开始 基于 Hudson 上 自行 创业 。 














Hudson 以 其 强大 的 功能 和 易 用 的 界面 征服 了 大 量 的 用 户 ， 它 与 主流 
的 构建 工具 、 版 本 控制 系统 以 及 自动 化 测试 框架 都 能 进行 很 好 的 集成 。 
因此 ， 很 多 组 织 和 公司 选择 它 作为 目 己 的 持续 集成 工具 ， 如 JBoss 的 
http://hudson.jboss.org/hudson/ 和 Sonatype 的 https://grid.sonatype.org/ci/。 


Hudson 还 有 一 个 优秀 之 处 就 是 它 提 供 了 灵活 的 插件 扩展 框架 ， 大 量 
开发 者 基于 这 种 机 制 对 Hudson 进 行 了 扩展 。 图 11-2 展 示 了 2006~2009 年 
Hudson 插 件数 量 的 增长 情况 ， 其 中 黑 柱 表示 当月 新 发 布 Hudson 插 件 ， 
白 柱 表 示 当 月 Hudson 插 件 的 总 数量 。 该 图 十 分 显著 地 展现 了 Hudson 插 
件 生态 系统 的 健康 状况 。 
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图 11-2 Hudson 插 件数 量 的 增长 情况 


11.3 ”安装 Hudson 


安装 Hudson 是 十 分 简便 的 。 需 要 注意 的 是 ，Hudson 必 须 运 行 在 JRE 
1.5 或 更 高 的 版 本 上 。 可 以 从 http://hudson-ci.org/ 下 载 最 新 版 本 的 安装 
包 ， 如 图 11-3 所 示 。 下 载 完 成 之 后 就 能 获得 一 个 hudson.war 文 件 。 


@ Hudson ct - Mozilla Firefox 
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图 11-3 下载 Hudson 安 装 包 





最 简单 的 启动 Hudson 的 方式 是 在 命令 行 直 接 运 行 hudson.war: 


$ java -jar hudson.war 





Hudson 的 启动 日 志 会 直接 输出 到 命令 行 ， 待 启动 完成 之 后 ， 用 户 就 
可 以 打开 浏览 器 输入 地 址 http://localhost: 8080/ 访 问 Hudson 的 界面 了 ， 
如 图 11-4 所 示 。 


要 停止 Hudson， 可 以 在 命令 行 按 下 Ctrl+C 键 。 


默认 情况 下 Hudson 会 在 端口 8080 下 运行 ， 这 可 能 会 与 用 户 已 有 的 
Web 应 用 相 冲 突 。 这 时 ， 用 户 可 以 使 用 --httpPort 选 项 指定 Hudson 的 运行 
端口 。 例 如 : 


$ java-jar hudson.war - -httpPort =8082 


既然 安装 包 是 一 个 war 文 件 ，Hudson 目 然 也 就 可 以 被 部 署 到 各 种 
Web asf, WTomcat, Glassfish, Jetty XJBoss=. 


这 里 以 Tomcat 6 为 例 ， 假 设 Tomcat 的 安装 目录 为 D: \bin\apache- 
tomcat-6.0.20\， 那 么 只 需要 复制 hudson.war 人 至 Tomcat 的 部 署 目 录 D: 
\bin\apache-tomcat-6.0.20\Wwebapps， 然 后 转 到 D: \bin\apache-tomcat- 
6.0.20\bin\ 目 录 ， 运 行 startup.bat。 这 时 可 以 从 Tomcat 的 console 输 出 中 看 
到 它 部 署 hudson.war。 


@ Dashboard [Hudson] - Mozilla Firefox 
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图 11-4 Hudson 的 初始 启动 界面 


待 Tomcat 局 动 完成 之 后 ， 打 开 浏 览 器 访问 http://localhost: 
8080/hudson 束 能 看 到 Hudson 的 界面 了 。 用 户 可 以 将 Tomcat 作 为 一 个 系 
统 服 务 运 行 ， 这 样 Hudson 束 能 目 动 随 操 作 系 统一 起 启动 了 。 








11.4 准备 Subversion 仓 库 


在 正式 创建 Hudson 持 续集 成 任务 之 前 ， 需 要 准备 好 版 本 控制 系统 。 
常见 的 版 本 控制 工具 有 CVS、Subversion、Git、Mercurial 等 。 由 于 
Subversion 可 能 是 当前 使 用 范围 最 广 的 版 本 控制 工具 ， 因 此 本 书 以 它 为 
例 进行 介绍 。 





首先 需要 安装 Subversion 服 务 器 软件 (本 书 仅 讨论 svnserve) 。 对 于 
大 多 数 Linux 发 行 版 和 Mac OS X 来 说 ， 该 工具 应 该 已 经 被 预先 安装 了 。 
可 以 运行 如 下 的 命令 查看 ， 见 代码 清单 11-1。 





代码 清单 11-1 在 Linux/Mac OS X 中 检查 svnserve 安 装 


$ svnserve — -version 
svnserve, version 1.5.5 (r34862) 


compiled Dec 23 2008, 16:20:31 
Copyright (C) 2000-2008 CollabNet. 
Subversion is open source software, see http://subversion, tigris.org/ 
This product includes software developed by CollabNet (http://www. Collab.Net/). 


The following repository back-end (FS) modules are available: 


* fs_base : Module for working with a Berkeley DB repository. 
* fs fs : Module for working with a plain file (FSFS) repository. 


Cyrus SASL authentication is available. 


对 于 Windows 用 户 来 说 ， 可 以 安装 Slik 


Subversion (http://www.sliksvn.com/en/download) 。 需 要 注意 的 是 ， 在 


选择 安装 类 型 的 时 候 ， 需 要 选择 complete 安 装 ， 否 则 默认 的 安装 方式 将 
不 会 安装 svnserve， 如 图 11-5 所 示 。 





W Slik Subversion 1.6.9 (x86) Setup 


Choose Setup Type 
Choose the setup type that best suits your needs 


LL wa 


Installs the most common program features. Recommended for most users. 


am features will be installed and where 
ended for advanced users. 





图 11-5 “完整 安装 Slik Subversion 





安装 完成 之 后 ， 可 以 运行 如 下 命令 进行 验证 ， 见 代码 清单 11-2。 


代码 清单 11-2 在 Windows 中 检查 svnserve 安 装 


D:\>svnserve — -version 
svnserve JRA 1.6.2 (SlikSvn:tag/l.6.2@ 37679) WIN32 
编译 于 May 11 2009,14:06:15 
版 权 所 有 (C) 2000-2009 CollabNet. 
Subversion 是 开放 源 代 码 软 件 , 请 参阅 http: //subversion. tigris.org/s}&. 
此 产品 包含 由 CollabNet (http: //www.Collab.Net/) 开发 的 软件 ， 


下 列 版 本 库 后 端 (FS) 神 块 可 用 : 


+ fs_base : 模块 只 能 操作 BDB MAE. 


* fs fs : 模块 与 文本 文件 (FSFS) 版 本 库 一 起 工作 . 


Cyrus SASL 认证 可 用 . 


接着 需要 创建 一 个 Subversion 人 仓库。 运行 命令 如 下 : 


D:\>mkdir svn-repos 


D:\>svnadmin create svn-repos \account 





svnadmin 是 用 来 创建 、 维 护 、 监 测 Subversion 仓 库 的 工具 ， 在 主流 


Linux 和 Mac OS X 上 一 般 都 是 预 装 的 。 在 Windows 上 ， 它 也 被 包含 在 Slik 
Subversion 中 。 这 里 首先 创建 一 个 名 为 svn-repos 的 目录 ， 然 后 在 这 个 目 
录 中 创建 一 个 Subversion 仓 库 。 


下 一 步 是 将 本 书 背 景 案例 现 有 的 代码 导入 到 这 个 Subversion 仓 库 


中 。 由 于 笔者 的 代码 和 Subversion 仓 库 在 一 台 机 器 上 ， 因 此 直接 使 用 file 
协议 导入 (导入 之 前 应 先 使 用 mvn clean 命 令 清 除 项 目 输出 文件 ， 这 些 文 
件 是 可 以 目 动 生成 的 ， 不 该 放 入 源码 库 中 ) ， 见 代码 清单 11-3。 


代码 清单 11-3 ”导入 源码 至 Subversion 仓 库 


$ svn import -m "initial import". file: ///D: /svn-repos /account /trunk 











增加 account-—emai 

增加 

增加 test 

增加 *\test iva 

增加 account-email \sre \test \java\com 

增加 account-emaāil\src\test \java \com\juvenxu 

增加 account-—email \sre \test \java \com\juvenxu \mvnbook 

增加 account-email \sre \test \java \com\juvenxu \mvnbook \account 

增加 account-email \sre \test \jJava \com\juvenxu \mvnbook \account \email 
增加 account-captcha \pom. xm] 


提交 后 的 版 本 为 1. 


上 述 命令 将 当前 目录 的 全 部 内 容 提 交 到 Subversion 仓 库 
的 /account/trunk 路 径 下 ，-m 选 项 表示 提交 的 注释 。 


仓库 建立 并 初始 化 完毕 ， 就 可 以 启动 svnserve 服 务 了 : 


$ svnserve -d -r svn-repos - -listen -host 0.0.0.0 





选项 -d 表 示 将 svnserve 服 务 作 为 守护 进程 运行 ，-r 表 示 Subversion 仓 
库 的 位 置 ， 而 参数 --listen-host 是 为 了 强制 将 svnserve 绑 定 到 IP v4 地 址 
(在 有 些 系统 上 ，svnserve 会 默认 绑 定 IP v6 地 址 ， 当 Hudson 使 用 IP v4 地 
址 访问 Subversion 仓 库 的 时 候 束 会 失败 〉。 


最 后 ， 可 以 用 简单 的 svn 命 令 检 查 插 件 svnserve 服 务 是 否 可 用 ， 见 代 
码 清单 11-4。 


代码 清单 11-4 ”检查 Subversion 仓 库 内 容 


$ svn list svn://192.168.1.101 /account /trunk 


.Classpath 


-project 
.settings/ 
account-captcha/ 
account-email/ 
account -—-parent / 
account-persist/ 


pom. xm 





至 此 ，Subversion 仓 库 就 建立 完成 了 ， 之 后 Hudson 束 可 以 基于 这 个 
仓库 运行 集成 任务 。 


11.5 Hudson 的 基本 系统 设置 


在 创建 Hudson 持 续集 成 任务 之 前 ， 用 户 需 要 对 Hudson 系 统 做 一 些 
基本 的 配置 ， 包 括 JDK 安 装 位 置 和 Maven 安 装 等 在 内 的 重要 信息 都 必须 
首先 配置 正确 。Hudson 会 使 用 这 些 配 置 好 的 JDK 及 Maven 进 行 持 续集 成 
任务 。 如 果 要 使 用 Ant 或 者 Shell 来 持续 集成 项 目 ，Ant 或 Shell 的 安装 位 置 
也 应 该 预先 设置 正确 。 


用 户 应 该 单 击 Hudson 登 录 页 面 左 边 的 “系统 管理 "， 然 后 单 击 页 面 右 
侧 的 “系统 设置 ”以 进入 系统 设置 页 面 ， 如 图 11-6 所 示 。 


生成 
当前 人 


KE 
bid 


Ne & 





图 11-6 ”进入 系统 设置 页 面 


在 系统 设置 页 面 ， 首 先 要 配置 的 是 Hudson 将 使 用 的 JDK。 在 页 面 中 


找到 对 应 的 部 分 ， 然 后 单 击 Add JDK 按 钮 ，Hudson 就 会 提示 用 户 进行 安 
装 。Hudson 默 认 会 提示 自动 安装 JDK， 用 户 可 以 看 到 一 个 Install 
automatically 的 复 选 框 是 被 选 上 的 ， 当 单 击 “同意 JDK 许 可 证 协议 ?并 选择 
一 个 JDK 版 本 后 ，Hudson 就 会 目 动 下 载 安装 相应 版 本 的 JDK。 








虽然 这 种 方式 非常 简单 ， 但 往往 用 户 在 本 机 已 经 有 可 用 的 JDK， 而 
且 不 想 花 时 间 等 待 Hudson 去 再 次 下 载 JDK。 这 时 用 户 就 可 以 取消 选中 
Install automatically 复 选 框 ， 然 后 手动 输入 本 机 JDK 的 位 置 (往往 就 是 
JAVA_HOME 环 境 变量 的 值 ) 。 


可 以 配置 多 个 JDK， 妆 你 的 项 目 需 要 确保 在 多 个 不 同 版 本 JDK 上 部 
能 正确 集成 的 时 候 ， 这 一 特性 尤为 有 用 。 





JDK 的 自动 及 手动 配置 方式 如 图 11-7 所 示 。 





与 JDK 配 置 类 似 ， 用 户 也 可 以 选择 手动 或 者 自动 安装 Maven 供 
Hudson 使 用 ， 还 可 以 安装 多 个 版 本 的 Maven 供 Hudson 集 成 任务 使 用 。 图 
11-8 显 示 了 手动 方式 指定 maven-3.0-beta-2 的 安装 位 置 。 


JDK 
JDK installations JDK 
Name jdk-1.6 


JAVA_HOME p:\java\jdk1.6.0_07 


|El Install automatically ®© 


Delete JIK | 


JDK 
Name 


[V] install automatically 


Install from java.sun.com 
Version 6 Update 19 Ea 


Mr agree to the Java SE Development Kit License Agreement 
© You must agree to the license to download the JDK. 


| Palate | 
ly Add Installer V | 
| Delete JIE 
a 


List of JDK installations on this system 





图 11-7 为 Hudson 配 置 JDK 


Maven 
Maven installations Maven 
Name maven-3.0-beta-2 


MAVEN_HOME D:\bin\apache-maven-3.0-beta-2 


_ Install automatically ® 


Delete Maven 


| Add Maven 





List of Maven installations on this system 


图 11-8 ”为 Hudson 配 置 Maven 


还 可 以 在 该 页 面 配 置 MAVEN_OPTS 环 境 变量 ， 如 图 11-9 所 示 。 关 
于 MAVEN_OPTS 环 境 变 量 的 具体 解释 可 参看 2.7.1 节 。 


Maven Project Configuration 


Global MAVEN_OPTS -Xmsi28m -Xmx512m 





图 11-9 ”为 Hudson 配 置 MAVEN_OPTS 环 境 变量 


最 后 ， 别 起 了 单 击 页 面 下 方 的 Save 按 钮 保存 系统 设置 。 


11.6 ”创建 Hudson 任 务 


要 创建 一 个 Hudson 任 务 来 持续 集成 Maven 项 目 ， 首 先 单 击 页 面 左边 
的 新 建 任务 ， 然 后 就 需要 在 页 面 右 边 选 择 任务 的 名 称 及 类 型 。 对 于 一 般 
的 Maven 项 目 来 说 ， 可 选择 的 类 型 有 Build a free-style software project 和 
Build a maven2 project。 前 者 不 仅 文 持 Maven 项 目 ， 还 文 持 其 他 类 型 的 构 
建 工 具 ， 如 Ant、Shell。 对 于 Maven 用 户 来 说 ， 两 者 最 大 的 不 同 在 于 前 
者 需要 用 户 进行 多 一 点 的 配置 ， 而 后 者 会 使 用 Hudson 上 自 市 的 Maven， 且 
从 项 目的 POM 中 获取 足够 的 信息 以 免 去 一 些 配 置 。 除 非 你 已 经 十 分 熟悉 
Hudson， 笔 者 推荐 选择 free-style 类 型 〈 见 图 11-10) 。 因 为 这 种 方式 更 
可 控制 ， 当 任务 出 现 问题 的 时 候 也 更 容易 检查 。 


Hudson » All 


228 account 
Build multi-configuration project (alpha) 
Suitable for projects that need a large number of different configurations, such as testing on 
multiple environments, platform-specific builds, etc. 
© Build a free-style software project 
This is the central feature of Hudson. Hudson will build your project, combining any SCM with 
any build system, and this can be even used for something other than software build. 
Monitor an external job 


This type of job allows you to record the execution of a process run outside Hudson, even on a 
remote machine. This is designed so that you can use Hudson as a dashboard of your existing 
automation system. See the documentation for more details. 





Build a maven2 project 


Build a maven2 project. Hudson takes advantage of your POM files and drastically reduces the 
configuration. 





图 11-10 选择 free-style 类 型 的 Hudson 任 务 


如 图 11-10 所 示 ， 输 入 任务 名 称 ， 并 选择 free-style 类 型 后 ， 单 击 OK 
按钮 即 可 进入 详细 的 任务 配置 页 面 。 


11.6.1 _ Hudson 任务 的 基本 配置 





下 面 依次 介绍 free-style 任 务 的 各 种 配置 。 首 先是 项 目的 名 称 和 描 
述 。 当 Hudson 任 务 比 较 多 的 时 候 ， 人 简洁 且 有 意义 的 名 称 及 描述 残 十 分 重 








va 


接着 是 一 个 重要 的 选项 Discard Old Builds。 该 选项 配置 如 何 抛弃 旧 
的 构建 。Hudson 每 执行 一 次 构建 任务 ， 就 可 以 保存 相应 的 源 代码 、 构 建 
输出 、 构 建 报告 等 文件 。 很 显然 ， 如 果 每 次 构建 相关 的 文件 都 保存 下 
来 ， 将 会 渐渐 消耗 光 磁盘 空间 。 为 此 ，Hudson 提 供 两 种 方式 让 用 户 选择 
保留 哪些 构建 任务 的 相关 文件 ， 它 们 分 别 为 : 


‘Days to keep builds: 如 果 其 值 为 非 空 的 N， 就 仅 保留 N 天 之 内 的 构 
ECF 0 








‘Max#of builds to keep: @0R#5E%, MAIRA REHA RILEY 
相关 文件 。 











图 11-11 所 示 的 配置 表示 最 多 保留 10 个 最 近 的 构建 。 


Project name account 


Description 《Maven 详 战 》 的 背 录 罕 列 项 目 ， 一 个 三 疡 注册 服务 


W] Discard Old Builds 
Days to keep builds 


if not empty, build records are only kept up to this number of days 


Max # of builds to keep 10 


if not empty, only up to this number of build records are kept 


| Advanced. .. | 


El This build is parameterized 


E| Disable Build (No new builds will be executed until the project is re-enabled.) 





E| Execute concurrent builds if necessary (beta) 


JDK jdk-1.6 
JDK to be used for this project 


图 11-11 Hudson 任务 的 基本 配置 





图 11-11 中 还 有 项 目 使 用 的 JDK 配 置 ， 这 里 可 供 选 择 的 JDK 就 是 用 户 
在 系统 设置 中 预先 定义 好 的 JDK。 


11.6.2 Hudson 任务 的 源码 仓库 配置 


接着 需要 配置 项 目的 源码 控制 系统 。 在 项 目 配置 页 面 的 Source Code 
Management 部 分 ， 选 择 Subversion 单 选 按钮 ， 然 后 在 Repository URL 
本 框 中 输入 项 目的 Subversion 仓 库 地 址 。 一 般 来 说 ， 该 部 分 的 其 他 选项 
保留 默认 值 即 可 ， 如 图 11-12 所 示 。 





Source Code Management 


None 
Cvs 
® Subversion 


Modules Repository URL svn://192.168.1.101/account/trunk 


Local module directory (optional) 


Add sore locations... | 





Use update F] 


If checked, Hudson will use 'svn update’ whenever possible, making the build faster, But this 
causes the artifacts from the previous build to remain when a new build starts. 


If checked, Hudson will do ‘svn revert’ before doing 'swn update’, This slows it down, but will 
prevent files being modified from build to build, 


Repository browser (Auto) 





| Advanced... 


图 11-12 Hudson 任务 的 源 代 码 管理 配置 


需要 注意 的 是 ， 如 果 访 问 Subversion 仓 库 需 要 认证 ，Hudson 会 自动 
探测 并 提示 用 户 输 入 认证 信息 ， 如 图 11-13 所 示 。 


® Subversion 


Modules Repository URL 


svn://192.168.1.101/account/trunk © 


Unable to access svn:/ /192.168.1.101/account/trunk : 


svn: No access allowed to this repository (show details) 
(Maybe you need to enter credential?) 





图 11-13 Hudson 提示 用 户 输入 源码 仓库 的 认证 信息 


单 击 enter credential 后 ，Hudson 会 弹出 一 个 页 面 让 用 户 选 择 认证 方 
式 并 输入 认证 信息 。 输 入 正确 信息 之 后 ，Hudson 就 能 读 取 仓库 源 代 码 
了 。 图 11-14 采 用 了 用 户 名 和 密码 的 方式 进行 认证 。 


À Subversion Authentication 


Repository URL syn://192.168.1.101/account/trunk 


© Username/password authentication 


User name juven 


Password eecceces 


SSH public key authentication (svn+ssh) 


HTTPS client certificate 





图 11-14 ”为 Subversion 仓 库 添 加 认证 信息 


11.6.3 Hudson 任务 的 构建 触发 配置 





再 往 下 的 Build Triggers 部 分 配置 的 是 触发 构建 的 方式 。 可 选 的 三 种 
方式 分 别 为 : 





.Build after other projects are built: 在 其 他 项 目 构 建 完 成 之 后 构建 本 
项 目 。 


‘Build periodically: 周期 性 地 构建 本 项 目 。 





‘Poll SCM: 周期 性 地 轮 询 源码 仓库 ， 发 现 有 更 新 的 时 候 构 建 本 项 


如 无 特殊 高 级 的 需要 ， 一 般 不 会 选择 第 一 种 方式 ， 而 第 二 种 方式 显 
然 会 造成 一 些 无 请 的 构建 ， 如 果 几 次 构建 所 基于 的 源 代码 没有 任何 区 
别 ， 构 建 的 输出 往往 也 就 不 会 有 变化 ;第 三 种 方式 就 没有 这 个 问题 ， 它 
能 避免 无 谓 的 构建 ， 节 省 持续 集成 服务 器 的 资源 。 这 种 周期 轮 询 产 代码 
仓库 的 方式 实际 上 也 是 最 常用 的 构建 触发 方式 。 











既然 是 轮 询 ， 就 需要 配置 轮 询 的 频 紊 ，Hudson 使 用 了 著名 的 UNIX 
任务 调度 工具 Cron (http://en.wikipedia.org/wiki/Cron〉 所 使 用 的 配置 方 
式 。 这 种 配置 方式 使 用 5 个 字段 表示 不 同 的 时 间 单 位 (字段 之 间 用 空格 








分 时 日 月 星期 几 





每 个 字段 表示 的 意义 及 值 范围 分 别 为 : 

分: 一 小 时 中 的 分 钟 (0~59) 。 

AY: 一 天 中 的 小 时 (0~23) 。 

日: 一 月 中 的 日 期 (1~31) 。 

JH: Att (1~12) 。 

.星期 几 : 一 周 中 的 星期 几 (0~7，0 和 7 都 表示 星期 天 )。 


其 中 每 个 字段 除了 可 以 使 用 其 范围 内 的 值 以 外 ， 还 能 使 用 一 些 特殊 








w 星 号 表示 匹配 范围 内 所 有 值 。 





M-N: 连 字 符 表 示 匹 配 M~<N 范 围 内 的 所 有 值 ， 如 “1-5”。 





‘A, B, 。。。? Z: Es Fer LACS ME, 如 “0， 15， 0”. 





-*/XEKM-N/X: 范围 加 上 和 斜 杜 表示 [匹配 范围 内 能 被 X 整 除 的 值 ， 
如 “1-10/3” 就 等 同 于 “3，6，9”。 


下 面 一 些 例子 可 以 帮助 读者 理解 这 种 强大 的 配置 方式 : 


.沙洲 炒米 。 每 分 钟 x 


Bees 每 小 时 中 的 第 5 分 钟 。 


:*/10****。 每 隔 10 分 钟 。 


-4510**1-5: 每 周一 到 周 五 的 上 午 10: 45. 





‘0, 30*13*5: 每 月 13 号 的 每 半 小 时 ， 或 者 每 周 五 的 每 半 小 时 。 


对 于 一 个 健康 的 项 目 来 说 ， 常 见 的 做 法 是 : 每 隔 10 分 钟 轮 询 代 码 仓 
库 ， 如 图 11-15 所 示 。 


Build Triggers 


“| Build after other projects are built 


Build periodically 


J| Poll SCM 


Schedule */19*#*** 





图 11-15 Hudson 任务 的 代码 仓库 轮 询 配 置 


在 配置 轮 询 的 时 候 ， 还 可 以 使 用 “ 坟 " 添 加 注释 ， 此 外 空白 的 行 会 被 
忽略 。 例 如 : 


# check if there is any subversion update every 15 minutes 


和 


11.6.4 Hudson 任务 的 构建 配置 


接 下 来 要 告诉 Hudson 使 用 运行 Maven 命 令 构 建 项 目 。 单 击 Build 部 分 
中 的 Add build step 下 三 角 按 钮 ， 然 后 选择 Invoke top-level Maven 
targets， 如 图 11-16 所 示 。 


Add build step Y 





Execute shell 
Invoke Ant 


Invoke top-level Maven targets 


Execute Windows batch command 
Realy Isage 








图 11-16 选择 Maven 作 为 Hudson 任 务 的 构建 工具 


再 选择 一 个 安装 好 的 Maven 版 本 ， 输 入 Maven 命 令 如 clean deploy Hk 
可 以 了 ， 如 图 11-17 所 示 。 需 要 注意 的 是 ,日 常 持 续集 成 任务 如 果 成 功 
的 话 ， 都 会 生成 快照 版 的 项 目 构 件 。 如 果 维 护 了 一 个 Maven 私 服 ， 那 么 
持续 集成 任务 就 应 当 自 动 将 构件 部 署 到 私服 中 ， 供 其 他 项 目 使 用 。 这 也 
就 是 这 里 的 Maven 命 令 应 当 为 clean deploy 的 原因 。 








至 此 ， 一 个 Hudson 任 务 基本 配置 完成 ， 单 击 Save 按 钮 保存 后 就 能 
到 图 11-18 所 示 的 页 面 。 这 时 ， 可 以 单 击 页 面 左 边 的 “立即 生成 ?来 手动 
触发 第 一 次 集成 。 


Build 
Invoke top-level Maven targets ® 





Maven Version | maven-3.0-beta-2 





Goals 


[=] 
clean deploy l [ED 


Delete 
Add build step v | 





图 11-17 Hudson 任 务 的 Maven 构 建 命令 配置 


Hudson » account 


Project account 


(Maven=&) HHRSAME. —bESSHES 


“OO Bll 


J Subversion Polling Lo 


永久 连接 
Build History (#3) 


a + a E 
@ #1 2010-4-11 16:51:04 Last build(#1),3.1 sec# 


A r 而 网 


国人 N 
图 11-18 配置 完成 的 Hudson 任 务 





11.7 监视 Hudson 任 务 状 态 


Hudson 提 供 了 丰富 友好 的 图 形 化 界面 ， 让 用 户 从 各 方面 了 解 各 个 任 
务 的 当前 及 历史 状态 ， 这 包括 整体 的 列表 显示 、 目 定义 视图 、 单 个 任务 
的 具体 信息 ， 如 构建 日 志和 测报 报告 等 。 用 户 应 该 基于 Hudson 提 供 的 信 
恩 尽 可 能 地 将 持续 集成 任务 稳定 在 健康 的 状态 。 





11.7.1 全 局 任务 状态 

Hudson 的 默认 主页 面 显示 了 当前 服务 器 上 所 有 集成 任务 的 状态 ， 如 
图 11-19 所 示 。 

这 个 页 面 主 要 由 四 个 部 分 组 成 : 


“SNR: 位 于 页 面 左上 方 ， 方 便 用 户 执行 各 类 Hudson 操 作 ， 如 
新 建 任 务 、 系 统管 理 等 。 


.生成 队列 : 页面 左边 中 间 的 部 分 ， 表 示 等 待 执行 构建 的 任务 ， 如 
图 11-19 中 有 一 个 maven3 的 构建 任务 在 等 待 生成 队列 中 。 


生成 状态 : 页 面 左边 下 面 的 部 分 ， 表 示 正 在 执行 构建 的 任务 ， 如 
图 11-19 中 有 一 个 account 的 构建 任务 正在 执行 。 


-任务 状态 : 页 面 右边 的 部 分 ， 显 示 了 所 有 任务 的 状态 。 


tA ENHE 








图 11-19 Hudson 的 全 局 任务 状态 


下 面 重 点 介绍 任务 状态 。 在 默认 情况 下 ， 这 里 列 出 了 Hudson 中 所 有 
任务 的 状态 ， 其 中 的 每 一 列 从 左 到 右 分 别 表示 任务 当前 状态 、 天 气 ， 名 
称 、 上 次 成 功 的 时 间 、 上 次 失败 的 时 间 、 上 次 持续 的 时 间 以 及 左右 一 个 
立即 执行 的 按钮 〈 方 便 用 户 手动 触发 执行 任务 ) 。 





其 中 需要 解释 的 是 当前 状态 及 图 中 第 一 列 (S) 下 的 球形 图 标 。 
Hudson 使 用 各 种 颜色 表示 任务 当前 的 状态 : 





E: 任务 最 近 一 次 的 构建 是 成 功 的 。 
红色 : 任务 最 近 一 次 的 构建 是 失败 的 。 


HE: 任务 最 近 一 次 的 构建 表 成 功 了 ， 但 不 稳定 (主要 是 因为 有 
失败 的 测试 ) 。 


TRE: 任务 从 未 被 执行 过 或 者 被 茶 用 了 。 
如 果 图 标 在 内 烁 ， 表 示 任 务 正 在 执行 一 次 构建 。 


图 中 的 第 二 列 天 气 W) 也 需要 稍 作 解释 。Hudson 使 用 一 组 天 气 的 
图 标 表示 任务 长 期 的 一 个 状态 ， 它 们 分 别 为 : 


万 里 晴空， 任务 80% 以 上 的 集成 都 是 成 功 的 。 


稍 有 乌云 ， 任 务 有 60%~80% 的 集成 是 成 功 的 。 
台 乌 云 密布 ， 任 务 只 有 40%~60% 的 集成 是 成 功 的 。 
编 轨 雨 绵 编 ， 任 务 的 集成 成 功率 只 有 20%~40%， 
念 电 闪 雷 鸣 ， 任 务 的 集成 成 功率 不 到 2096。 


关于 全 局 状态 需要 再 次 强调 的 是 ， 当 团队 看 到 任务 的 集成 状态 不 够 
健康 时 ， 应 该 尽快 采取 措施 修复 问题 。 





11.7.2 目 定 义 任务 视图 





在 一 个 稍 有 规模 的 公司 或 者 组 织 下 ， 持 续集 成 服务 顺 上 往往 会 有 很 
多 的 任务 ，Hudson 默 认 的 视图 会 列 出 所 有 服务 器 上 的 任务 ， 太 多 的 任务 
就 会 造成 寻找 的 不 便 。 为 此 Hudson 能 让 用 户 目 定义 视图 ， 选 择 只 列 出 感 
兴趣 的 任务 ， 甚 至 还 能 自 定 义 视图 中 显示 的 列 。 


用 户 可 以 单 击 默认 视图 Al 劳 边 的 加 号 (+) 以 添加 一 个 自 定 义 视 
图 ， 如 图 11-20 所 示 。 


Name 


Description 


Filter build queue 
Filter build executors F] 


Jobs 


W| account 


f 1 
| maven3 
Use a regular expression to include jobs into the view 
Columns 


Status 


Weather 


Job 





图 11-20 添加 目 定 义 Hudson 任 务 视 图 


图 11-20 添 加 了 一 个 名 为 mvn-book 的 任务 视图 ， 该 视图 仅 包含 
account 一 个 任务 ， 并 且 只 显示 状态 、 天 和气、 任务 名 三 列 。 用 户 可 以 根据 
目 己 的 需要 ， 选 择 要 包含 的 任务 和 要 显示 的 列 ， 甚 至 还 能 使 用 正则 表达 
式 来 匹配 要 显示 的 任务 名 。 上 述 配置 保存 后 的 效果 如 图 11-21 所 示 。 





s (Maven=a) HE 


All mvn-book + 








图 11-21 自 定 义 Hudson 任 务 视图 效果 


11.7.3， 单 个 任务 状态 


在 任务 视图 中 ， 单 击 某 个 任务 名 称 就 能 进一步 查看 该 任务 的 状态 。 
图 11-22 显 示 了 account 项 目 任务 的 一 个 整体 状态 。 


Project account 


(Mavenž i HERRARE —E HNES 


aw SEE 


5 运 
Se sEEEs 


Test Result Trend 


u ion in 
Latest Test 
Build History ( eeu) Result(no failures) 


o-nNnNWOBR MUON DO 
#2 


@ #5 2010-4-12 9:59:23 永久 连接 

@ #4 2010-4-12.9:20:51 

@ #3 2010-4-12 9:10:51 | © Last build(#5),1 day 5 hr 区 
Latetnble build(#5 y Sheet 

@ #2 2010-4-11 17:01:54 | © Last successful build(#5),1 day 5 hr 前 

@ #1 2010-4-11 16:51:04 | 





图 11-22 ”单个 Hudson 任 务 的 状态 


图 11-22 包 含 了 丰富 的 信息 。 左 下 角 是 构建 历史 (Build History) , 
该 例 中 显示 了 最 近 5 次 全 部 成 功 的 构建 ， 包 括 每 次 构建 的 时 间 。 图 11-22 
方 还 有 3 个 永久 连接 ， 分 别 指向 了 最 近 一 次 构建 、 最 近 一 次 失败 的 构 
建 以 及 最 近 一 次 成 功 的 构建 。 无 论 构建 历史 还 是 永久 连接 ， 我 们 都 能 
击 某 一 个 构建 以 了 解 更 具体 的 信息 。 例 如 ， 单 击 图 11-22 构 建 历史 中 的 
#4 构建 ， 就 可 以 看 到 图 11-23 所 示 的 内 容 。 





© 生成 #4 (2010-4-12 9:20:51) 


zanas 387 11 sec 
SERS; 4 


Changes 


1. add developers config for jason (detail) 


Started by an SCM change 


B Test Result(no failures) 


图 11-23 Hudson 任务 的 单 次 构建 信息 





请 注意 图 11-23 左 上 和 角 的 导航 信息 ，Hudson>account>#4 表 示 当 前 的 
位 置 是 Hudson 服 务 器 下 account 任 务 的 第 4 次 构建 。 从 图 11-23 中 可 以 了 解 
到 这 次 构建 所 发 生 的 时 间 、 相 关 的 代码 变更 等 信息 。 


需要 指出 的 是 ， 在 图 11-23 中 左边 的 命令 行 输出 链接 。 当 构建 失败 
的 时 候 ， 了 解 这 次 构建 的 命令 行 输入 至 关 重 要 。 单 击 该 链接 后 可 以 看 到 
图 11-24 所 示 的 页 面 。 


O 命令 行 输出 


Started br an SCM change 

Updating svn://192. 168. 1. 101/account/ trunk 

U account-parent\poz xml 

At revision 4 

[trunk] $ D:\bin\apache-maven-3. O-alpha-6\bin\mvn. bat clean install 

[INFO] Scanning for projects. 

[INFO] SaO ni a 
[INFO] Reactor Build Order: 

(INFO) 
[INFO] Aggregator 
[INFO] Parent 
[INFD] Email 
[INFO] Persist 
[INFO] Captcha 
[INFO] 
[INFO] 
[INFO] Building Account Aggregator 1. 0. 0-SNAPSHOT 
8 SSS SSS 
[INFO] 
[INFO] -一 maven-clean-plugin:2.3:clean (default-clean) @ account-aggregator 一 一 
[INFO] 
[INFO] --- maven-install-plugin:Z. 3-install (default-install) @ account-aggregator 一 一 

[INFO] Installing D:\hudson-work\ jobs\account\workspaca\trunk\poa. xml to D:\java\repository 

\com\ juvenxu \zvnbook\account \account~aggregator\1. 0. 0-SNAPSHOT\account-agersgator-1. 0. O-SNAPSHOT. pom 
[INFO] 
[INFO] 











图 11-24 Hudson 执 行 构建 的 命令 行 输出 


在 图 11-22 中 还 有 一 些 链 接 包 含 了 丰富 的 信息 ， 例 如 最 近 变 更 集 。 
单 击 该 链接 就 能 看 到 项 目 最 近 的 代码 变更 ， 如 图 11-25 所 示 。 


变更 集 
#4 (2010-4-12 9:20:51) 


4. add developers config for jason — jason / detail 


#3 (2010-4-12 9:10:51) 


3. add developers config for admin — admin / detail 
2. add developers config — Juven Xu / detail 





图 11-25 Hudson 任务 的 变更 集 


除了 变更 集 ， 还 可 以 单 击 工作 区 ， 以 图 形 化 的 方式 查看 该 Hudson 从 
源码 库 取得 的 源码 文件 及 构建 输入 文件 ， 如 图 11-26 所 示 。 


= trunk / account-captcha / src / main / 


-svn 


java/com/juvenxu/mvnbook/account/captcha 


resources 





图 11-26 Hudson 任务 的 工作 区 


11.7.4 Maven 项 目测 试 报告 


图 11-22 还 显示 了 项 目的 测试 结果 信息 ， 为 了 获得 这 样 的 信息 需要 
做 一 些 额 外 的 配置 。 在 11.6.1 节 中 ，maven-surefire-plugin 会 在 项 目的 
target/surefire-reports 目 录 下 生成 与 JUnit 兼 容 的 XML 格 式 测试 报告 ， 
Hudson 能 够 基于 这 种 格式 的 文件 生成 图 形 化 的 测试 报告 。 


用 户 可 以 配置 一 个 Hudson 任 务 ， 在 配置 页 面 的 Post-build Actions 部 
分 选择 Publish JUnit test result report W, JF Hf Test report XMLs 赋 值 


为 **/target/surefire-reports/TEST-*.xml。 





该 表达 式 表 示 匹 配 任意 目录 下 target/surefire-reports/ 子 目录 中 以 
TEST- 开 头 的 XML 文件 ， 这 也 了 束 是 匹配 所 有 maven-surefire-plugin 生 成 的 
XML 格式 报告 文件 。 配 置 如 图 11-27 所 示 。 


4| Publish JUnit test result report 


Test report XMLs **/target/surefire-reports/TEST-*.xml 


Fileset ‘includes’ setting that specifies the generated raw XML report files, such as 
'myproject/target/test-reports/*.xml', Basedir of the fileset is the workspace root 





图 11-27 ”配置 Hudson 任 务 发 布 测试 报告 


有 了 上 述 配置 之 后 ， 就 能 在 任务 状态 页 面 中 看 到 最 新 的 测试 结果 与 
测试 结果 趋势 ， 如 图 11-28 所 示 。 





Test Result Trend 











图 11-28 ”Hudson 任务 测试 的 总 体 状 态 


单 击 Latest Test Result 就 能 看 到 最 近 一 次 构建 的 测试 报告 。 在 测试 
结果 趋势 图 中 ， 用 户 也 可 以 单 击 各 个 位 置 得 到 对 应 构建 的 测试 报告 ， 如 
图 11-29 所 示 。 





用 户 还 可 以 单 击 图 中 的 链接 得 到 更 具体 的 测试 输出 ， 以 方便 定位 并 


修复 问题 。 


如 果 用 户 为 一 个 Hudson 任 务 配 置 了 测试 报告 ， 就 可 以 同时 配置 构建 
命令 忽略 测试 。 例 如 ， 图 11-17 中 的 Maven 构 建 命令 可 以 更 改 为 clean 
deploy-Dmaven.test.failure.ignore， 这 样 失败 的 测试 就 不 会 导致 构建 失 
败 。 也 就 是 说 ， 构 建 的 状态 不 会 是 红色 ， 同 时 ， 由 于 Hudson 能 够 解析 测 
试 报 告 并 发 现 失败 的 测试 ， 构 建 的 状态 也 不 会 是 健康 的 蓝 色 。 用 户 最 终 
会 看 到 黄色 的 任务 状态 ， 表 示 构 建 不 稳定 。 这 种 配置 方式 能 够 帮助 用 户 
区 分 失败 的 构建 与 不 稳定 的 构建 。 


Test Result 


1 failures (+1) 
[和 和 和 和 和 和 和 
9 tests (+0) 


(q2znEs 
All Failed Tests 


Test Name Duration Age 


>>> com.juvenxu.mvnbook.account.captcha.AccountCaptchaServiceTest.testValidateCaptchaCorrect 0.047 


All Tests 


Package Duration Fail (diff) Skip (diff) Total (diff) 
com. juvenxu,mvynbook.account.captcha 2.7 sec +1 
com.juvenxu,mvnbook.account.email | 0.47 sec | | 
com.juvenxu.mvnbook.account.persist | 0.48 sec. 





图 11-29 一 次 构建 的 测试 报告 


11.8 Hudson 用 户 管理 





与 一 般 软件 的 用 户 管理 方式 不 同 的 是 ， 使 用 Hudson 时 ， 不 需要 主动 
创建 用 户 ，Hudson 能 够 在 访问 源码 仓库 的 时 候 上 自动 获取 相关 用 户 信 息 并 
存储 起 来 。 这 大 大 简化 了 用 户 管理 的 步 又。 





以 11.4 节 建立 的 Subversion 仓 库 为 例 ， 默 认 该 仓库 是 匿名 可 读 的 ， 
认证 用 户 可 写 ， 不 过 我 们 并 没有 配置 任何 用 户 。 现 在 要 关闭 匿名 可 读 权 
限 ， 同 时 添加 一 些 用 户 。 本 书 不 涉及 过 多 的 配置 细节 ， 可 以 参考 

《Subversion 与 版 本 控制 》 (http://svnbook.red-bean.com/) 一 书 。 





首先 ， 编 辑 Subversion 仓 库 下 conf/svnserve.conf 文 件 中 的 [general ] 
小 节 如 下 : 


[general] 

I ri—access = 
uth-access =write 
assword-db=pa d 








这 里 的 anon-access=none 表 示 匿 名 用 户 没有 任何 权限 ，auth- 
access=write 表 示 经 认证 用 户 拥有 读 写 权限 ， 而 password-db=passwd 表 示 
存储 用 户 信息 的 数据 位 于 同 级 目录 下 的 passwd 文 件 中 。 再 编辑 
conf/passwd 文 件 如 下 : 





amin dmini23 
juven = juve 
jason Sonl23 





这 里 为 仓库 配置 了 三 个 用 户 ， 等 号 左边 是 用 户 名 ， 右 边 则 是 密码 。 





至 此 ， 就 完成 了 一 个 简单 的 Subversion 仓 库 用 户 权 限 配置 。 像 日 常 
开发 一 样 ， 接 下 来 在 Subversion 客 户 端 分 别 使 用 这 几 个 用 户 名 对 代码 进 
行 更 改 后 提交 至 Subversion 仓 库 。 例 如 ， 对 account-parent 模 块 的 pom.xml 
加 入 developers 配 置 后 ， 再 使 用 如 下 svn 命 令 提交 更 改 : 


D:\svn\account > svn commit-m "add developers config" — -username juven — — pass-— 
word juvenl123 

EA Rik account-parent \pom. xml 

传输 文件 数据 . 


提交 后 的 版 本 为 2. 


然后 使 用 另外 两 个 用 户 admin 与 jason 分 别 对 代码 进行 更 改 并 提交 ， 
Hudson 会 很 快 轮 询 到 Subversion 仓 库 内 的 更 改 ， 然 后 取得 更 改 的 代码 信 
妃 ， 并 了 解 到 这 些 更 改 是 由 谁 提交 的 。 


待 Hudson 得 到 这 些 更 改 并 触发 集成 任务 之 后 ， 相 关 的 Subversion 用 
户 信息 就 已 经 被 Hudson 存 储 起 来 了 。 单 击 Hudson 页 面 左 边 的 用 户 ， 然 
后 就 能 在 页 面 右边 看 到 相关 的 用 户 信息 ， 包 括 用 户 名 、 最 近 活动 时 间 及 
相关 的 Hudson 任 务 ， 如 图 11-30 所 示 。 


Last Active t 


4 min 33 sec account 


14 min account 


14 min account 





图 11-30 ”Hudson 自 动 获得 的 用 户 信息 


当然 ， 仅 仅 知道 用 户 名 是 不 够 的 ， 还 需要 为 用 户 添加 详细 信息 ， 其 
中 最 重要 的 就 是 E-mail 地 址 ， 因 为 它 将 被 用 来 发 送 邮 件 反馈 〈 详 见 11.9 
节 ) 。 单 击 某 个 用 户 的 名 称 〈 如 juven) ， 然 后 再 单 击 页 面 左 边 的 设 
置 ， 在 右边 的 用 户 设置 页 面 中 ， 可 以 配置 用 户 的 名 称 〈 不 同 于 
Subversion ID， 该 名 称 应 该 更 容易 识别 人 ) 、 简 要 描述 、 个 性 化 视图 以 
及 最 重要 的 E-mail 地 址 ， 如 图 11-31 所 示 。 





Hudson » juven 
Your name Juven Xu 


Description Mavena) 的 作 老 


My Views 
Default View Al 


The view selected by default when navigating to the users private views 


E-mail 


E-mail address juyvenshun@gmail.com 


Your e-mail address, like joe chin@sun com 





图 11-31 配置 Hudson 用 户 的 详细 信息 


单 击 Save 按 钮 后 ， 一 个 Hudson 用 户 的 信息 束 完 整 了 。 


11.9 邮件 反馈 


持续 集成 中 非常 重要 的 一 个 步骤 就 是 反 饿 。 集 成 的 状态 信息 〈 尤 其 
征 不 健康 的 状态 信息 ) 必须 及 时 地 通知 给 相关 团队 成 员 ， 而 最 向 见 的 反 
饥 方 式 就 是 使 用 电子 邮件 。 本 小 节 介绍 如 何 配置 Hudson 来 及 时 地 发 送 集 
成 反馈 邮件 。 





首先 需要 做 的 是 为 Hudson 配 置 邮件 服务 器 信息 。 进 入 11.5 节 提 到 的 
系统 设置 页 面 ， 找 到 E-mail Notification 部 分 ， 然 后 输入 以 下 信息 : 


-SMTP server: SMTP 邮 件 服务 器 地 址 。 


‘Default user e-mail suffix: 默认 用 户 邮 件 后 经。 当 用 户 没 有 配置 邮 
件 地 址 的 时 候 ，Hudson 会 自动 为 其 加 上 该 邮件 后 级 。 当 用 户 数 量 很 多 ， 
并 且 邮 件 地 址 都 是 一 个 域名 的 时 候 ， 该 功能 就 显得 尤其 重要 ， 例 如 配置 
后 缀 为 @foo.com， 且 用 户 mike 没 有 配置 邮件 地 址 ， 那 么 当 Hudson 需 要 
发 邮件 给 mike 的 时 候 就 会 发 送 到 mike@foo.com。 


‘System Admin E-mail Address: 系统 管理 员 邮 件 地 址 ， 即 Hudson 邮 
件 提示 所 使 用 的 发 送 地 址 。 


-Hudson URL: Hudson 服 务 器 的 地 址 。 该 地 址 往往 被 包含 在 电子 邮 
件 中 以 方便 用 户 访 问 Hudson 取 得 进一步 的 信息 ， 因 此 要 确保 该 地 址 在 用 


户 机 器 上 是 可 访问 的 。 


.SMTP Authentication: SMTP 相 关 的 认证 配置 。 


完整 的 邮件 服务 器 配置 如 图 11-32 所 示 。 


E-mail Notification 


SMTP server smtp.gmail.com 


Default user e-mail suffix @juvenxu.com 


System Admin E-mail Address hudson@juvenxu.com 
Hudson URL http://192.168.1.101:8080/ 
J! Use SMTP Authentication 

User Name hudson 


Password eeeeeeeocces 


Use SSL 


SMTP Port 








图 11-32 Hudson 邮件 服务 配置 


配置 完成 后 ， 可 以 单 击 图 11-32 右 下 角 的 测试 按钮 ， 让 Hudson 发 一 
封 邮件 至 系统 管理 员 邮 件 地 址 以 确认 配置 成 功 。 


接 下 来 要 做 的 是 配置 Hudson 任 务 使 用 邮件 反馈 。 进 入 任务 的 配置 页 
面 ， 然 后 找到 最 后 Post-build Actions 小 节 中 的 E-mail Notification 复 选 
框 ， 将 其 选 上 。 现 在 要 关心 的 是 两 个 问题 : 什么 样 的 构建 会 触发 邮件 反 
馈 ? 邮件 会 发 送 给 谁 ? 


天 于 第 一 个 问题 ， 答 案 是 这 样 的 : 


失败 的 构建 会 触发 邮件 反馈 。 


成功 构建 后 的 一 次 不 稳定 构建 会 触发 邮件 反馈 。 不 稳定 往往 是 由 
失败 的 测试 引起 的 ， 因 此 成 功 后 的 一 次 不 稳定 往往 表示 有 回归 性 测试 失 
败 。 


失败 或 不 稳定 构建 后 的 一 次 成 功 构 建 会 触 友 邮件 反馈 ， 以 通知 用 
户 集成 恢复 到 了 健康 状态 。 





用 户 可 以 配置 是 人 否 每 次 不 稳定 构建 者 触发 邮件 反馈 。 


关于 第 二 个 问题 ， 首 先 可 以 在 Recipients 中 配置 一 个 邮件 列表 (用 
空格 分 离 )》， 列 表 中 的 用 户 会 收 到 所 有 邮件 反馈 。 一 般 来 说 ， 项 目 负 责 
人 应 该 在 这 个 列表 中 。 


其 次 ，Hudson 还 提供 一 个 选项 : Send separate e-mails to individuals 
who broke the build。 当 用 户 选 择 该 选项 后 ， 邮 件 会 及 送 给 所 有 与 这 次 构 
建 相关 的 成 员 ， 即 那些 提交 了 本 地 构建 代码 更 新 的 成 员 。Hudson 无 法 精 
确 地 知道 到 底 是 谁 的 代码 提交 导致 了 构建 失败 ， 因 此 只 能 通知 所 有 与 代 
码 更 新 相关 的 成 员 。 


典型 的 邮件 反馈 配置 如 图 11-33 所 示 。 


v| E-mail Notification 


Recipients admin@juvenxu.com 


Whitespace-separated list of recipient addresses. E-mail will be sent when a build fails. 


¥) Send e-mail for every unstable build 





Vi Send separate e-mails to individuals who broke the build 


图 11-33 ”为 Hudson 任 务 配 置 邮 件 反 馈 





最 后 需要 解释 的 是 ， 图 11-33 中 的 Send e-mail for every unstable build 
选项 表示 是 否 为 所 有 的 不 稳定 构建 触发 邮件 反馈 ， 如 果 不 将 其 选中 ， 只 
有 成 功 构 建 后 的 第 一 次 不 稳定 构建 才 会 触发 邮件 反馈 。 推 荐 的 做 法 是 将 
其 选 上 。 敏 捷 高 效 的 团队 不 应 该 忽略 持续 集成 中 的 任何 不 健康 因素 。 








11.10 Hudson 工作 目录 


到 目前 为 止 ， 本 章 都 是 从 用 户 界面 的 角度 介绍 Hudson 的 各 种 功能 。 
用 心 的 读者 可 以 想象 到 ，Hudson 的 各 种 配置 、 任 务 、 报 告 肯定 是 以 文件 
的 形式 存储 在 磁盘 中 的 。 这 就 是 Hudson 的 工作 目录 ， 了 解 该 目录 不 仅 能 
帮助 读者 理解 Hudson 用 户 界 面 中 的 各 种 特性 ， 更 重要 的 是 ， 该 者 需要 明 
白 怎 样 为 Hudson 分 配合 理 的 磁盘 空间 ， 长 期 运行 的 持续 集成 服务 往往 会 
消耗 大 量 的 磁盘 空间 ， 理 解 哪些 任务 对 应 的 哪些 文件 消耗 了 多 少 磁 盘 空 
间 ， 对 持续 集成 服务 的 维护 来 说 至 关 重 要 。 





默认 情况 下 ，Hudson 使 用 用 户 目 录 下 的 .hudson/ 目 录 作 为 其 工作 目 
录 。 例 如 ， 在 笔者 的 Vista 系 统 上 ， 该 目录 为 C: \Users\juven\.hudson\, 
而 在 Linux 系 统 上 ， 该 目录 为 home/juven/.hudson/。 由 于 该 目录 会 渐渐 消 
耗 大 量 的 磁盘 空间 ， 因 此 用 户 往往 会 希望 自 定 义 该 工作 目录 的 位 置 ， 这 
时 用 户 可 以 设置 环境 变量 HUDSON_HOME， 例 如 将 其 设置 为 D: 
\hudson-work。 关 于 如 何 设置 环境 变量 ， 请 参考 2.1.3 节 和 2.2.1 节 。 


一 个 典型 的 Hudson 工 作 目 录 包 含 的 内 容 如 图 11-34 所 示 。 
对 这 些 文 件 、 目 录 的 解释 如 下 : 


xml: 这 些 XML 文 件 是 Hudson 核 心 及 相关 插件 的 配置 ， 如 
config.xml 配 置 了 全 局 的 JDK、 任 务 视 图 等 信息 ，hudson.tasks.Maven.xml 


配置 了 Maven 安 装 信 息 ，hudson.tasks.Mailer.xml 配 置 了 邮件 服务 器 信 


Aft Ay 
昌 ， 等 等 。 


CA 


Name 





b [Ea jobs 

b i plugins 

> 上 updates 

b g userContent 

b Ea users 

b [Ea war 
config.xml 
hudson.maven.MavenModuleSet.xml 
hudson.model.UpdateCenter.xml 

| hudson.scm.CVSSCM.xml 
hudson.scm.SubversionSCM.xml 
hudson.tasks.Ant.xml 
hudson.tasks.Mailer.xml 
hudson.tasks.Maven.xml 


hudson.tasks.Shell.xml 


| hudson.triggers.SCMTrigger.xml 


nodeMonitors.xml 





secret.key 





图 11-34 ”Hudson 工作 目录 的 内 容 


‘war: 如 果 用 户 独 立 运行 hudson.war， 那 么 其 内 容 会 被 释放 到 该 目 
录 中 后 再 局 动 。 


‘users: Hudson 所 存储 的 用 户 信 息 。 


'UserContent: 用 户 可 以 将 任意 内 容 放 到 该 目录 下 后 通过 Hudson 服 
务 页 面 的 子路 径 访问 ， 如 http:/192.168.1.101: 8080/userContent/。 





‘updates: 这 里 存储 了 各 类 可 更 新 的 插件 信息 。 





‘plugins: 所 有 Hudson 插 件 都 被 安装 在 该 目录 而 不 会 影响 到 Hudson 


的 核心 。 


‘jobs: 该 目录 包含 了 所 有 Hudson 任 务 的 配置 、 存 储 的 构建 、 归 档 的 
构建 输出 等 内 容 。 本 节 稍 后 会 详细 解释 该 目录 。 





上 述 目 录 中 最 重要 的 可 能 就 是 jobs 子 目录 了 ， 这 里 包含 了 所 有 
Hudson 的 任务 配置 、 每 个 任务 的 工作 区 、 构 建 历史 等 信息 ， 具 体内 容 如 
图 11-35 所 示 。 





图 11-35 中 的 jobs 目 录 下 有 两 个 子 目 录 account 和 maven3， 它 们 分 别 
对 应 了 两 个 Hudson 任 务 。 每 个 任务 都 会 包含 如 config.xml、 
nextBuildNumber、scm-polling.log 等 文件 ， 其 中 的 config.xml 包 含 了 该 任 
务 的 所 有 配置 ， 如 SCM 地 址 、 轮 询 频 率 等 。 





每 个 任务 目录 下 会 包含 一 个 workspace 子 目录 ， 这 就 是 该 任务 的 工 
作 区 。 这 里 有 最 近 一 次 构建 所 包含 的 源 代码 及 相关 输出 。 


任务 目录 下 还 有 一 个 builds 子 目录 ， 该 目录 包含 了 所 有 Hudson 记 录 
的 历史 构建 ， 每 个 构建 对 应 了 一 个 目录 ， 这 些 目录 都 是 以 构建 所 发 生 的 
时 间 命 名 的 ， 如 2010-04-15_14-56-08， 每 个 构建 目录 包含 了 一 些 文件 记 
录 其 成 功 失败 信息 、 构 建 日 志 、 测 试 报告 、 变 更 记录 等 。 如 果 用 户 为 该 
任务 配置 了 文件 归档 ， 那 么 每 次 构建 归档 的 内 容 都 会 存储 在 archive 子 目 
有 下 








g jobs 
vV Ba account 
v E builds 
b E 2010-04-12_09-20-51 
b BD 2010-04-13_15-50-57 
b E 2010-04-14_13-56-16 
b BD 2010-04-15_14-49-53 
v E 2010-04-15_14-56-08 
> Ba archive 


g build.xml 


@) changelog.xml 


© junitResult.xml 
| log 
三 | revision.txt 
jn workspace 
>》 jo trunk 
@| config.xml 
“| nextBuildNumber 
_ `| scm-polling.log 


svnexternals.txt 





> jaa maven3 


111-35 Hudson 工作 目录 的 jobs 子 目录 内 容 


可 以 想象 ， 如 果 用 户 没有 如 11.6.1 节 中 介绍 的 那样 殷 弃 旧 的 构建 ， 
那么 每 次 构建 的 记录 都 会 保存 在 任务 目录 的 builds 子 目录 下 。 随 者 时 间 
的 推移 ， 这 些 记录 会 消耗 大 量 的 磁盘 空间 ， 因 此 用 户 在 使 用 Hudson 的 时 
候 应 该 按照 实际 情况 为 其 分 配 足 够 的 磁盘 空间 ， 同 时 合理 地 抛弃 旧 的 构 


建 记录 。 


11.11 小结 


本 章 关 注 的 是 持续 集成 。 首 先 介绍 了 持续 集成 相关 的 概念 ， 在 此 基 
础 上 ， 再 引入 最 流行 的 持续 集成 服务 软件 
于 安装 ， 它 与 主流 的 版 本 控制 工具 都 集成 得 很 好 ， 为 了 真实 地 体现 持续 
集成 场景 ， 本 章 简略 介绍 了 如 何以 设 简单 的 Subversion 人 仓库。 使 用 
Hudson 创 建 持续 集成 任务 会 涉及 很 多 配置 ， 如 JDK 安 竣 、Maven 安 装 、 
源码 库 、 构 建 触 发 方式 、 构 建 命令 等 ， 本 章 配 以 大 量 的 图 片 以 帮助 读者 
使 用 和 理解 这 些 配置 。 任 务 创建 完成 后 ， 还 能 从 各 方面 了 解 任 务 的 状 
态 ， 包 括 成 功 与 否 、 测 试 报告 、 源 码 变更 记录 等 。Hudson 还 能 够 智能 地 
收集 用 户 信 息 ， 读 者 可 以 配置 Hudson 为 用 户 提 供 邮 件 反 馈 。 本 章 的 最 后 
介绍 了 Hudson 的 工作 目录 ， 以 帮助 读者 更 好 地 维护 持续 集成 服务 。 





Hudson. Hudson 非 常 易 








第 12 半 ”使 用 Maven 构 建 Web 应 用 


“Web 项 目的 目录 结构 
-account-service 
-account-web 


.使 用 jetty-maven-plugin 进 行 测试 





.使 用 Cargo 实 现 自动 化 部 署 


小 结 





到 目前 为 止 ， 本 书 讨论 的 只 有 打包 类 型 为 JAR 或 者 POM 的 Maven 项 
目 。 但 在 现今 的 互联 网 时 代 ， 我 们 创建 的 大 部 分 应 用 程序 都 是 Web 应 
用 ， 在 Java 的 世界 中 ，Web 项 目的 标准 打包 方式 是 WAR。 因 此 本 章 介绍 
一 个 WAR 模 块 一 一 account-web， 它 也 来 自 于 本 书 的 账户 注册 服务 背景 
案例 。 在 介绍 该 模块 之 前 ， 本 章 还 会 先 实现 account-service。 此 外 ， 还 
介绍 如 何 借助 jetty-maven-plugin 来 快速 开发 和 测试 Web 模 块 ， 以 及 使 用 
Cargo 实 现 Web 项 目的 上 自动 化 部 署 。 








12.1 Web 项 目的 目录 结构 


我 们 都 知道 ， 基 于 Java 的 Web 应 用 ， 其 标准 的 打包 方式 是 WAR。 
WAR 与 JAR 类 似 ， 只 不 过 它 可 以 包含 更 多 的 内 容 ， 如 JSP 文 件 、 
Servlet、Java 类 、web.xml 配 置 文件 、 依 赖 JAR 包 、 静 态 web 资 源 〈 如 
HTML、CSS、JavaScript 文 件 ) 等。 一 个 典型 的 WAR 文 件 会 有 如 下 目录 
结构 : 


—war/ 
+ META-INF/ 
+ WEB-INF / 
| +.classes/ 
| + ServletA.class 
+ config. properties 


errr oak | 


ib/ 
+ Gom4j-1.4.1.Jjar 


| 
| | 

村 | 

Leal 

[4 

Lil 

| | + mail-1.4.1. jar 
teal 

| | 

| + 

| 


+ index.html 


+ sample, jsp 


一 个 WAR 包 下 至 少 包含 两 个 子 目 录 : META-INF 和 WEB-INF。 前 


者 包含 了 一 些 打 包 元 数据 信息 ， 我 们 一 般 不 去 关心 ; 后 者 是 WAR 包 的 
核心 ，WEB-INF 下 必须 包含 一 个 Web 资源 表述 文件 web.xml， 它 的 子 目 
录 classes 包 含 所 有 该 Web 项 目的 类 ， 而 另 一 个 子 目录 lib 则 包含 所 有 该 
Web 项 目的 依赖 JAR 包 ，classes 和 lib 目 录 都 会 在 运行 的 时 候 被 加 入 到 
Classpath 中 。 除 了 META-INF 和 WEB-INF 外 ， 一 般 的 WAR 包 都 会 包含 很 
多 Web 资 源 ， 例 如 你 往往 可 以 在 WAR 包 的 根 目录 下 看 到 很 多 html 或 者 
jsp 文 件 。 此 外 ， 还 能 看 到 一 些 文件 夹 如 img、css 和 js， 它 们 会 包含 对 应 
的 文件 供 页 面 使 用 。 








同 任何 其 他 Maven 项 目 一 样 ，Maven 对 Web 项 目的 布局 结构 也 有 一 
通用 的 约定 。 不 过 首先 要 记 住 的 是 ， 用 户 必 须 为 Web 项 目 显 式 指定 打 
包 方 式 为 war， 如 代码 清单 12-1 所 示 。 


代码 清单 12-1 显 式 指定 Web 项 目的 打包 方式 为 war 





如 果 不 显 式 地 指定 packaging，Maven 会 使 用 默认 的 jar 打 包 方 式 ， 从 
而 导致 无 法 正确 打包 Web 项 目 。 





Web 项 目的 类 及 资源 文件 同一 般 JAR 项 目 一 样 ， 默 认 位 置 都 是 


src/main/java/ 和 src/main/resources， 测 试 类 及 测试 资源 文件 的 默认 位 置 是 
src/test/java/ 和 src/test/resources/。Web 项 目 比 较 特殊 的 地 方 在 于 : 它 还 有 
一 个 Web 资 源 目录 ， 其 默认 位 置 是 src/main/webapp/。 一 个 典型 的 Web 项 
目的 Maven 目 录 结 构 如 下 : 


+ 
| 

| 

| 

| 

| + resources/ 
| | + config. properties 
l BA 

| 

| + webapp / 

| + WEB-INF / 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 


+ web, xml 


| 
| 
| 
+ css/ 
| 
4 
+ 
+ 
+ 


在 src/main/webapp/ 目 录 下 ， 必 须 包 含 一 个 子 目录 WEB-INF， 该 子 
目录 还 必须 要 包含 web.xml 文 件 。src/main/webapp 目 录 下 的 其 他 文件 和 





目录 包括 html、jsp、css、JavaScript 等 ， 它 们 与 WAR 包 中 的 Web 资 源 完 
全 一 致 。 


在 使 用 Maven 创 建 Web 项 目 之 前 ， 必 须 首先 理解 这 种 Maven 项 目 结 
构 和 WAR 包 结构 的 对 应 关系 。 有 一 点 需要 注意 的 是 ，WAR 包 中 有 一 个 
lib 目 录 包 含 所 有 依赖 JAR 包 ， 但 Maven 项 目 结构 中 没有 这 样 一 个 目录 ， 
这 是 因为 依赖 都 配置 在 POM 中 ，Maven 在 用 WAR 方 式 打包 的 时 候 会 根 
据 POM 的 配置 从 本 地 仓库 复制 相应 的 JAR 文 件 。 








12.2 account-service 








本 章 将 完成 背景 案例 项 目 ， 读 者 可 以 回顾 第 4 草 ， 除 了 之 前 实现 的 
account-email、account-persist 和 account-captcha 之 外 ， 该 项 目 还 包括 
account-service 和 account-web 两 个 模块 。 其 中 ，account-service 用 来 封装 
底层 三 个 模块 的 细节 ， 并 对 外 提供 人 简单 的 接口 ， 而 account-web 仪 包含 一 


些 涉 及 Web 的 相关 内 容 ， 如 Servlet 和 JSP 等 。 


12.2.1 account-service 的 POM 


account-service 用 来 封装 account-email、account-persist 和 account- 
captcha 三 个 模块 的 细节 ， 因 此 它 衣 定 需要 依赖 这 三 个 模块 。account- 
servVice 的 POM 内 容 如 代码 清单 12-2 所 示 。 


代码 清单 12-2 _ account-service 的 POM 


<project xmlns = "http ://maven. apache. org/POM/4.0.0" 

xmins:xsi = "http://www.w3.org/2001 /XMLSchema-instance" 

xsi:schemaLocation = "http://maven. apache. org/POM/4.0.0 

http: //maven. 

apache. org /maven-v4_0_0.xsd" > 

<modelVersion >4.0.0 < /modelVersion > 

<parent > 
< groupiId >com. juvenxu.mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId> 
<version >1.0.0-SNAPSHOT < /version > 

< /parent > 


<artifactId >account-service < /artifactId > 
<name >Account Service < /name > 


<properties > 
<greenmail.version>1.3.1b< /greenmail. version > 
< /properties > 


<dependencies > 
< dependency > 
<groupld > $ {project. groupId} < /groupid > 
<artifactId >account-email < /artifactId> 
<version > $ {project. version} < /version > 
< /dependency > 


< dependency > 
<groupid > $ {project. groupid}< /groupid > 
<artifactId>account-persist < /artifactId> 
<version > $ {project. version} < /version > 
< /dependency > 
< dependency > 
<grouplId> $ {project. groupid} < /groupId > 
<artifactId >account-captcha < /artifactId > 
<version> $ {project. version} < /version > 
< /dependency > 
< dependency > 
<groupid > junit < /groupid > 
<artifactid >junit < /artifactId> 
< /dependency > 
< dependency > 
<groupid >com. icegreen < /groupId > 
<artifactId >greenmail < /artifactId> 
<version > $ {greenmail.version} < /version > 
<scope > test < /scope > 
< /dependency > 
< /dependencies > 
<build> 
<testResources > 
<testResource > 
<directory >src/test /resources < /directory > 
<filtering >true</filtering > 
< /testResource > 
< /testResources > 
< /build> 


< /project > 


与 其 他 模块 一 样 ，account-service 继 承 自 account-parent， 它 依赖 于 
account-email、account-persist 和 account-captcha 三 个 模块 。 由 于 是 同一 
项 目 中 的 其 他 模块 ，groupId 和 version 都 完全 一 致 ， 因 此 可 以 使 用 Maven 
属性 $ {project.groupId} 和 $ {project.version} 进 行 蔡 换 ， 这 样 可 以 在 升级 
项 目 版 本 的 时 候 减 少 更 改 的 数量 。 项 目的 其 他 配置 如 junit 和 greenmail 依 
赖 ， 以 及 测试 资源 目录 过 滤 配 置 ， 都 是 为 了 单元 测试 。 前 面 的 章节 已 经 
介绍 过 ， 这 里 不 再 袭 述 。 








12.2.2 ”account-service 的 主 代码 





account-service 的 目的 是 封装 下 层 细节 ， 对 外 暴露 尽 可 能 简单 的 接 
口 。 先 看 一 下 这 个 接口 是 怎样 的 ， 见 代码 清单 12-3。 





代码 清单 12-3 AccountService.java 


package com. juvenxu. mvnbook. account. service; 
public interface AccountService 


String generateCaptchaKey () 


throws AccountServiceException; 

byte [] generateCaptchalImage( String captchaKey ) 
throws AccountServiceException; 

void signUp(S 
throws AccountServiceException; 


ignUpRequest signUpRequest ) 


void activate( String activationNumber ) 
throws AccountServiceException; 


void login( String id, String password ) 
throws AccountServiceException; 


正如 4.3.1 节 介绍 的 那样 ， 该 接口 提供 5 个 方法 。 
generateCaptchaKey ©) 用 来 生成 一 个 验证 码 的 唯一 标识 符 。 
generateCaptchalmage O 根据 这 个 标识 符 生 成 验证 码 网 乒 ， 图 请 以 字 节 
流 的 方式 返回 。 用 户 需 要 使 用 signUp O 方法 进行 注册 ， 注 册 信 息 使 用 
SignUpRequest 进 行 封装 ， 这 个 SignUpRequest 类 是 一 个 简单 的 POJO， 它 
包含 了 注册 ID、email、 用 户 名 、 密 码 、 验 证 码 标识 、 验 证 码 值 等 信 


息 叫 。 注 册 成 功 之 后 ， 用 户 会 得 到 一 个 激活 链接 ， 该 链接 包含 了 一 个 激 
活 码 ， 这 个 时 候 用 户 需 要 使 用 activate O 方法 并 传 入 激活 码 以 激活 账 
户 。 最 后 ，login () 方法 用 来 登录 。 





下 面 来 看 一 下 该 接口 的 实现 类 AccountServiceImpl.java。 首 先 它 需要 
使 用 3 个 底层 模块 的 服务 ， 如 代码 清单 12-4 所 示 。 


代码 清单 12-4 AccountServiceImpl.java 第 1 部 分 


public class AccountServic RETNI 
implements AccountService 


private AccountPersistService accountPersistService; 
private AccountEmailService accountEmailService; 
private AccountCaptchaService accountCaptchaService; 
public AccountPersistService getAccountPersistService () 


return accountPersistService; 
} 


public void setAccountPersistService( AccountPersistService accountPersist- 


Service ) 


this. accountPersistService =accountPersistServic 


三 个 私有 变量 来 自 account-persist、account-email 和 account-captcha 


模块 ， 它 们 都 有 各 自 的 get O Mse O 方法 ， 并 且 通 过 Spring 注入 。 


AccountServiceImpl.java 借 助 accountCaptchaService 实 现 验证 码 的 标 
识 符 生成 及 验证 码 图 片 生成 ， 如 代码 清单 12-5 所 示 。 


代码 清单 12-5 AccountServiceImpl.java 第 2 部 分 


public byte[] generateCaptchaImage( String captchaKey ) 
throws AccountServiceException 


try 
{ 
return accountCaptchaService. generateCaptchalImage( captchakey ); 
} 
catch ( AccountCaptchaException e ) 
{ 


throw new AccountServiceException ("Unable to generate Captcha Image.", e ); 
} 


public String generateCaptchaKey () 
throws AccountServiceException 
{ 
try 
{ 
return accountCaptchaService. generateCaptchaKkey (); 
} 
catch ( AccountCaptchaExceptione ) 
í 
throw new AccountServiceException( "Unable to generate Captcha key.", e ); 


稍微 复杂 一 点 的 是 signUp《〈) 方法 的 实现 ， 见 代码 清单 12-6。 


SA 


代码 清单 12-6 AccountServiceImpl.java 第 3 部 分 


private Map < String, String > activationMap =new HashMap <String, String> (); 


public void signUp( SignUpRequest signUpRequest ) 
throws AccountServiceException 


ea 


try 
if (!signUpRequest . get Password (). equals (signUpRequest.getConfirmPassword ())) 
{ 
throw new AccountServiceException( "2 passwords do not match." ); 


} 


if (!accountCaptchaService 
. validateCaptcha (signUpRequest. getCaptchaKey (),signUpRequest. 
getCaptchaValue())) 


{ 


throw new AccountServiceException( "Incorrect Captcha." ); 


} 


Account account =new Account (); 

count. Ee oe 1est.getId() ); 
account. setEmail (| siqnUpRequest.qgetEmail () ); 
account. dat Naime ( signt IPF Request. getName () Ms 
account. setPasswora( signU Vos quest.get Password () ); 
account.setActivated( false ); 


accountPersistService. createAccount ( account ) ; 
String activationId =RandomGenerator. getRandomString(); 
activationMap. put ( activationld, account. getId() ); 


String link =signUpRequest.getActivateServiceUrl ().endsWith( "/" ) ? sign- 
UpRequest.getActivateServiceUr] () 
+ acti ionId : signUpRequest. getActivateServiceUrl () + "?key=" + 
activationid; 


accountEmailService. sendMail ( account.getEmail(), "Please Activate Your 
Account", link ); 
} 


catch ( AccountCaptchaException e ) 


throw new AccountServiceException( "Unable to validate captcha.", e ); 
} 


catch ( AccountPersistException e ) 


throw new AccountServiceException( "Unable to create account.", e }; 
} 
catch ( AccountEmailException e ) 
throw new AccountServiceException( "Unable to send actiavtion mail.",e 


} 





signUp O 方法 首先 检查 请 求 中 的 两 个 密码 是 否 一 致 ， 接 着 使 用 
accountCaptchaService 检 查验 证 码 ， 下 一 步 使 用 请 求 中 的 用 户 信 息 实例 
化 一 个 Account 对 象 ， 并 使 用 accountPersistService 将 用 户 信息 保存 。 下 一 
步 是 生成 一 个 随机 的 激活 码 并 保存 在 临时 的 activateMap 中 ， 然 后 基于 该 
激活 码 和 请 求 中 的 服务 器 URL 创 建 一 个 激活 链接 ， 并 使 用 
accountEmailService 将 该 链接 发 送 给 用 户 。 如 果 其 中 任何 一 步 发 生 异 





ti, signUp O 方法 会 创建 一 个 一 致 的 AccountServiceExcpetion 对 象 ， 
提供 并 抛 出 对 应 的 异常 提示 信息 。 


最 后 再 看 一 下 相对 简单 的 activate () 和 login O 方法 ， 见 代码 清单 
12-7. 


代码 清单 12-7 AccountServiceImpl.java 第 4 部 分 


public void activate( String activationtid ) 


throws AccountServiceException 


String accountId =activationMap. get ( activationId ); 
if ( accountId ==nulli ) 
{ 
throw new AccountServiceException( “Invalid account activation ID." ); 


me 
Ħ 
he 


Account account =accountPersistService,. readAccount ( accountId }; 
account. setActivated( true ); 
account PersistService. updateAccount { account ); 

} 

catch ( AccountPersistException e } 


{ 


throw new AccountServiceException( "Unable to activate account." ); 


public void login{ String id, String password } 
throws AccountServiceException 


try 
{ 
Account account =accountPersistService. readAccount ( id ); 
if ( account ==null ) 
{ 
throw new AccountServiceException( "Account does not exist.” ); 
} 
if { !account.isActivated{)} ) 
{ 
throw new AccountServiceException( "Account is disabled." ); 
} 


if { !account.getPassword().equals( password ) ) 


一 


throw new AccountServiceException( "Incorrect password." ); 


, 
i 


catch ( AccountPersistException e } 
{ 
throw new AccountServiceException( "Unable to log in.",e); 


activate O 方法 仅仅 是 简单 根据 激活 码 从 临时 的 activationMap 中 寻 
找 对 应 的 用 户 ID， 如 采 找 到 就 更 新 账户 状态 为 激活 。login〈) 方法 则 是 





根据 ID 读 取 用 户 信 息 ， 检 查 其 是 否 为 激活 ， 并 比 对 密码 ， 如 果 有 任何 错 
误 则 抛 出 异常 。 


除了 上 述 代码 之 外 ，account-service 还 包括 一 些 Spring 配 置 文件 和 单 
元 测试 代码 ， 这 里 就 不 再 详细 介绍 。 有 兴趣 的 读者 可 以 自行 下 载 阅读 。 


[1] 由 于 篇 幅 的 原因 ， 这 里 不 再 给 出 源 代码 ， 有 兴趣 的 读者 可 以 自行 下 
载 并 查看 本 书 源码 。 


12.3 account-web 


account-web 是 本 书 背景 案例 中 唯一 的 web 模块 ， 本 书 旨 在 用 该 模块 
来 阐述 如 何 使 用 Maven 来 构建 一 个 Maven 项 目 。 由 于 account-service 已 经 
封装 了 所 有 下 层 细 节 ，account-web 只 需要 在 此 基础 上 提供 一 些 Web 页 
面 ， 并 使 用 简单 Servlet 与 后 台 实 现 交 互 控制 。 读 者 将 会 看 到 一 个 具体 
Web 项 目的 POM 是 怎样 的 ， 也 将 能 体会 到 让 Web 模 块 尽 可 能 简洁 带 来 的 
好 处 。 


12.3.1 account-web 的 POM 





除了 使 用 打包 方式 war 之 外 ，Web 项 目的 POM 与 一 般 项 目 并 没 多 大 
的 区 别 。account-web 的 POM 代 码 见 代码 清单 12-8。 


代码 清单 12-8 ”account-web 的 POM 


<?xml version = "1.0"?> 
<project 
xSi:schemaLocation = "http://maven. apache. org/POM/4.0.0 
http://maven. 
apache. org /xsd/maven-4.0.0.xsd" 
xmlns = "http://maven. apache. org/POM/4.0.0" 
xmlns:xsi = "http://www. w3.org/2001/XMLSchema-instance" > 
<modelVersion >4.0.0 < /modelVersion > 
<parent > 
<groupiId >com. juvenxu.mvnbook. account < /groupid > 
<artifactid >account-parent < /artifactid > 


<version >1.0.0-SNAPSHOT < /version > 
< /parent > 


<artifactId >account-web < /artifactId> 
< packaging >war < /packaging > 
<name >Account Web < /name > 


< dependencies > 
< dependency > 
<groupld> $ {project. groupid} < /groupiId > 
<artifactid >account-service < /artifactid> 
<version > $ {project. version} < /version > 
< /dependency > 
< dependency > 
<groupId > javax. servlet < /GroupIQG > 
<artifactId >servlet-api < /artifactId> 
<version >2.4 < /version > 
< scope >provided < /scope > 
< /dependency > 
< dependency > 
<groupId > javax. servlet. jsp < /groupIQ > 
<artifactId >jsp-api < /artifactId> 
<version >2.0 < /version > 


g. springframework < /groupId > 


factId >spring-web < /artifactId> 





如 上 述 代码 所 示 ，account-web 的 packaging 元 素 值 为 war， 表 示 这 是 
一 个 Web 项 目 ， 需 要 以 war 方 式 进 行 打包 。account-web 依 赖 于 servlet-api 
和 jsp-api 这 两 个 几乎 所 有 Web 项 目 都 要 依赖 的 包 ， 它 们 为 servlet 和 jsp 的 
编写 提供 文 持 。 需 要 注意 的 是 ， 这 两 个 依赖 的 范围 是 provided， 表 示 它 
们 最 终 不 会 被 打包 至 war 文 件 中 ， 这 是 因为 几乎 所 有 Web 容 器 都 会 提供 
这 两 个 类 库 ， 如 果 war 包 中 重复 出 现 ， 就 会 导致 潜在 的 依赖 冲突 问题 。 
account-web 还 依赖 于 account-service 和 spring-web， 其 中 前 者 为 Web 应 用 
提供 底层 支持 ， 后 者 为 Web 应 用 提供 Spring 的 集成 支持 。 





在 一 些 Web 项 目 中 ， 读 者 可 能 会 看 到 finalName 元 素 的 配置 。 该 元 素 
用 来 标识 项 目 生 成 的 主 构件 的 名 称 ， 该 元 素 的 默认 值 已 在 超级 POM 中 设 
定 ， 值 为 $ {project.artifactId}- $ {project.version}， 因 此 代码 清单 12-8 对 
应 的 主 构件 名 称 为 account-web-1.0.0-SNAPSHOT.war。 不 过 ， 这 样 的 名 
称 显 然 不 利于 部 署 ， 不 管 是 测试 环境 还 是 最 终 产品 环境 ， 我 们 都 不 想 在 
访问 页 面 的 时 候 输 入 元 长 的 地 址 ， 因 此 我 们 会 需要 名 字 更 为 简洁 的 war 
包 。 这 时 可 以 如 下 上 所 示 配 置 finalName 元 又 : 








z finalName >account < /finalName > 





经 此 配置 后 ， 项 目 生 成 的 war 包 名 称 就 会 成 为 account.war， 更 方便 
[人 


12.3.2 account-web 的 主人 代码 

account-web 的 主 代码 包含 了 2 个 JSP 页 面 和 4 个 Servlet， 它 们 分 别 
H: 

‘signup.jsp: 账户 注册 页 面 。 

-login.jsp: 账户 登录 页 面 。 


-CaptchalmageServlet: 用 来 生成 验证 码 图 片 的 Servlet。 





:LoginServlet: 处 理 账 户 注 册 请 求 的 Servlet。 
“ActivateServlet: 处 理 账户 激活 的 Servlet。 
:LoginServlet: 处 理 账 户 登录 的 Servlet。 


Servlet 的 配置 可 以 从 web.xml 中 获得 ， 该 文件 位 于 项 目的 
src/main/webapp/WEB-INF/ 目 录 。 其 内 容 见 代码 清单 12-9。 


代码 清单 12-9 ”account-web 的 web.xml 


< IDOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc. //DTD Web Application 2.3//EN" 


"http://java.sun.com/dadtd/web-app_2_3.dtd" > 


<web-app > 
<display—name > Sample Maven Project: Account Service < /display-name > 
<listener > 
listener-class >org, springframework. web. context. ContextLoaderListener 
</listener-cla 
< / listener > 
<context-param > 
< param-name > contextConfigLocation < /param-name > 
<param-value > 
classpath: /account-persist. xml 
classpath: /account-captcha. xml 
classpath: /account-email. xml 
classpath: /account-service. xml 
Daram-value > 
< f/context-param > 
<servlet > 
<servlet-name >CaptchalmageServlet < /servlet-name > 
< serviet-class > com. juvenxu. mvnbook, account.web.CaptchaImageServlet </ serv— 














<servlet > 


<servlet-name > SiqnUpServlet < /servlet-name > 





<servlet-class > com. jJuvenxu. mynbook. account. web. SignUpServlet < / servlet- 


<servlet—-name >ActivateServlet < /servlet-name > 
< servlet-class > com. juvenxu.mynbook. account. web. ActivateServlet < / serv- 


<servilet—-name >LoginServlet < /servlet—name > 
< servlet-class > com. juvenxu. myvnbook. account. web. LoginServlet </ servlet- 
class > 
</serviel > 
<serviet-mapping > 
<servilet-name >CaptchaImageServlet < /servlet-name > 
<url—-pattern > /< "ha _ image < /url-pattern > 
/Bervlet—mapping > 
<Serviet-mapping > 
<Servlet—name > SignUpServilet < /servlet-name > 
<url-pattern> /signup < /url—pattern > 
< /servlet—mapping > 
servlet-mapping > 
< servlet-name >ActivateServlet < /servlet-name > 
<url-pattern > /activate </ 
< /servlet-mapping > 
‘servlet—mapping > 
<servlet—-name > Logi 
<url-pattern > /login «< /url-pattern > 
< /servlet-mappine 
< /web-app > 





A 





i 


A 


Servlet < /servlet-name > 


3 








web.xml 首 先 配 置 了 该 Web 项 目的 显示 名 称 ， 接 着 是 一 个 名 为 
ContextLoaderListener 的 ServletListener。 该 listener 来 自 Spring-web， 它 用 
来 为 Web 项 目 启动 Spring 的 IoC 容 器 ， 从 而 实现 Bean 的 注入 。 名 为 
contextConfigLocation 的 context-param 则 用 来 指定 Spring 配置 文件 的 位 


置 。 这 里 的 值 是 四 个 模块 的 Spring 配置 XML 文件 ， 例 如 

classpath: Waccount-persist.xml 表 示 从 classpath 的 根 路 径 谈 取 名 为 account- 
persist.xml 的 文件 。 我 们 知道 account-persist.xml 文 件 在 account-persist 模 
块 打 包 后 的 根 路 径 下 ， 这 一 JAR 文 件 通 过 依赖 的 方式 被 引入 到 account- 
web 的 classpath 下 。 


web.xml 中 的 其 余部 分 是 Servlet， 包 括 各 个 Servlet 的 名 称 、 类 名 以 及 
对 应 的 URL 模 式 。 


下 面 来 看 一 个 位 于 src/main/webapp/ 目 录 的 signup.jsp 文 件 ， 该 文件 用 
来 呈现 账户 注册 页 面 。 其 内 容 如 代码 清单 12-10 所 示 。 


代码 清单 12-10 signup.jsp 


<% @ page contentType = "text /html; charset =UTF-8" language = "java" % > 
<% @ page import = "com. juvenxu.mvnbook. account. service. +, 
org. springframework. context.ApplicationContext, 
org. springframework. web. context. support.WebApplicationContextUtils"% > 
<html > 
<head > 
<style type = "text /css"> 


</style> 
</head> 
< body > 


<$ 
ApplicationContext context = WebApplicationContextUtils.getWebApplicationContext ( 
getServletContext () ); 


AccountService accountervice = (AccountService) context.getBean ( "“accountSer- 
vice" ); 

String captchakKey =accountervice. generateCaptchaKey ({); 

$ > 


<div class ="text-field"> 


<h2 > 注册 新 账户 < /h2 > 

<form name = "signup" action = "signup" method = "post" > 
<label >K P ID: < /label > <input type = "text" name = "id" » </input > <br/> 
<label >Email: < /label > <input type = "text" name = "email"> < /input > 


<br/> 

<label > 显示 名 称 : < /label > <input type = "text" name = "name" > < /input > 
<br/> 

<label > 密码 :< /label > <input type = "password" name = "password" > < /input > 
EDE 


<label > 确认 密码 :< /label > <input type = "password" name = "confirm_password" > 
< /input > <br/> 

< label > 验证 码 : </label > <input type = "text" name = "captcha_value" > </ in- 
put > <br/> 

<input type = "hidden" name = "captcha_key" value=" <% =captchaKey% >"/> 

<img src="<% =request.getContextPath()% > /captcha_image?key = <% =cap- 
tchaKey%® >"/> 

</br> 


<button > 确认 并 提交 < /button > 
</form> 
</div> 


< / body > 
< /html > 


该 JSP 的 主题 是 一 个 name 为 signup 的 HIML FORM， 其 中 包含 了 
ID、Email、 名 称 、 密 码 等 字段 ， 这 与 一 般 的 HIML 内 容 并 无 差别 。 不 
同 的 地 方 在 于 ， 访 JSP 文件 引入 了 Spring 的 ApplicationContext 类 ， 并 且 用 


此 类 加 载 后 台 的 accountService， 然 后 使 用 accountService 先 生成 一 个 验 
证 码 的 key， 再 在 FORM 中 使 用 该 key 调 用 captcha_image 对 应 的 Servlet 生 
成 其 标识 的 验证 码 图 片 。 需 要 注意 的 是 ， 上 述 代 码 中 略 去 了 css 片 段 。 





账户 注册 页 面 如 图 12-1 所 示 。 


上 述 JSP 中 使 用 到 了 /captcha_image 这 一 资源 获取 验证 码 图 片 。 根 据 
web.xml， 我 们 知道 该 资源 对 应 了 CaptchaImageServlet。 下 面 看 一 下 它 的 
代码 ， 见 代码 清单 12-11。 


注册 新 账户 
账户 ID; Juven 


Email: test@juvenxu. com 
显示 名 称 ， Juven XU 
密码 : SOSees 


HUEZ: eeceece 
验证 码 : 6c8x7 i 


Bo8x7 | 


| 确认 并 提交 | 


图 12-1 ”账户 注册 页 面 
代码 清单 12-11 CaptchalmageServlet.java 


package com. juvenxu. mvnbook. account. web; 


import java.io. IOException; 
import ... 


public class CaptchaImageServlet 
extends HttpServlet 


private ApplicationContext context; 


private static final long serialVersionUID =5274323889605521606L; 


@ Override 
public void init () 
throws ServletException 


super.init (); 


context =WebApplicationContextUtils. getWebApplicationContext ( getServ- 


letContext () ); 


} 


public void doGet (HttpServletRequest request, HttpServletResponse response) 
throws ServletException, 
IOException 
String key =request.getParameter( "key" ) 
if (key ==null || key. length() ==0 ) 
esponse.sendError (400, “No Captcha Key Found" ); 
} 
else 


AccountService service (AccountService) context. getBean ( "account- 
Service" ); 
try 
i 
response. setContentType{ "image/jpeg" ); 
OutputStream out = response, getOutputStream (); 
out.write( service. generateCaptchaImage (key ) ); 


ast > Pen lls 
out. CLOSE |); 


catch ( AccountServiceException e ) 


response. sendError (404, e.getMessage() ); 


CaptchalmageServlet7Einit O 方法 中 初始 化 Spring 的 
ApplicationContext， 这 一 context 用 来 获取 Spring Bean。 Servlet 的 
doGet O 方法 中 首先 检查 key 参 数 ， 如 果 为 空 ， 则 返回 HTTP 400 错 误 ， 
标识 客户 端的 请 求 不 合法 ， 如 采 不 为 空 ， 则 载 入 AccountService 实 例 。 
该 类 的 generateCaptchaImage () 方法 能 够 产生 一 个 验证 人 码 图 片 的 字 市 
流 ， 我 们 将 其 设置 成 image/jpeg 格 式 ， 并 写 入 到 Servlet 相 应 的 输出 流 





中 ， 客 户 端 就 能 得 到 图 12-1 所 示 的 验证 码 图 片 。 


代码 清单 12-10 中 FROM 的 提交 目标 是 signup， 其 对 应 了 


SignUpServlet。 其 内 容 如 代码 清单 12-12 所 示 。 
代码 清单 12-12 SignUpServlet.java 


public class SigqnUpServlet 
extends HttpServlet 


private static final long serial VersionUID =4784742296013868199L; 
private ApplicationContext context; 


@ Override 
public void init () 
throws ServletException 
{ 
super. init (); 
context =WebApplicationContextUtils. getWebApplicationContext ( getServ— 
letContext () }; 
} 


@ Override 
protected void doPost ( HttpServletRequest reg, HttpServletResponse resp ) 
throws ServletException, 
IOException 


String id=req.getParameter ( "id" }; 

String email =req. getParameter ( "email" }; 

String name =req. getParameter ( "name" }; 

String password =req.getParameter | "password" ); 

String confirmPassword =req. get Parameter ( "confirm_password" ); 
String captchakey =req. getParameter ( "captcha_key" }; 

String captchaValue =req.getParameter( "captcha_value" }; 


if (id==null ||id-length() ==0 || email ==null || email.length() ==0 || 
name ==nuil 
|| name. length() ==0 || password ==null || password. length() ==0 || con- 
firmPassword ==null 
|| confirmPassword. length () ==0 || captchakey ==null || captchaKey. length 
()==0 || captchaValue ==null 
|| captchaValue. length({) ==0 } 
{ 
resp. sendError (400, "Parameter Incomplete." }; 
return; 
} 


AccountService service = (AccountService) context. getBean ( "“accountSer- 
vice" ); 


SignUpRequest request =new SignUpRequest {); 


request. setId( id); 

request. setEmail ( email ); 

request. setName (name ) ; 

request. set Password (| password ); 

request. setConfirmPassword ( confirmPassword ); 
request. setCaptchaKkey ( captchakey ); 

request. setCaptchaValue( captchaValue ); 


request, setActivateServiceUrl ( getServletContext ().getRealPath( “/") + 
"activate" ); 


try 


yuest ); 
resp.getWriter().print( "Account is created, please check your mail box 
act t Link, " 
h ( AccountServiceExce one 
resp. sendError (400, e.getMessage({} ); 
return; 


SignUpServletiJdoPost () 接受 客户 端的 HTTP POST 请 求 ， 首 先 它 
读 取 请 求 中 的 id、name、email 等 参数 ， 然 后 验证 这 些 参数 的 值 是 人 否 为 
室 ， 如 果 验 证 正确 ， 则 初始 化 一 个 SignUpRequest 实 例 ， 其 包含 了 注册 
账户 所 需要 的 各 类 数据 。 其 中 的 activateServiceUrl 表 示 服 务 应 该 基于 什 
么 地 址 发 送 账户 激活 链接 邮件 ， 这 里 的 值 是 与 signup 平 行 的 activate 地 
址 ， 这 正 是 ActivationServlet 的 地 址 。SignUpServlet 使 用 AccountService 
注册 账户 ， 所 有 的 细节 都 已 经 封装 在 AccountService 中 ， 如 果 注 册 成 
功 ， 服 务 器 打印 一 条 简单 的 提示 信息 。 


上 面 介绍 了 一 个 JSP 和 两 个 Servlet， 它 们 都 非常 简单 。 鉴 于 篇 幅 的 
原因 ， 这 里 就 不 再 详细 解释 男 外 几 个 JSP 及 Servlet。 感 兴趣 的 读者 可 以 
目 行 下 载 本 书 的 样 例 源码 。 


12.4 ”使 用 jetty-maven-plugin 进 行 测试 


在 进行 Web 开 发 的 时 候 ， 我 们 总 是 无 法 避免 打开 浏览 絮 对 应 用 进行 
测试 ， 比 如 为 了 验证 程序 功能 、 验 证 页 面 布局 ， 尤 其 是 一 些 与 页 面相 关 
的 特性 ， 手 动 部 车 到 Web 容 器 进行 测试 似乎 是 唯一 的 方法 。 近 年 来 出 现 
了 很 多 自动 化 的 Web 测试 技术 如 Selenium， 它 能 够 录制 Web 操 作 ， 生 成 
各 种 语言 脚本 ， 然 后 目 动 重复 这 些 操 作 以 进行 测试 。 应 该 说 ， 这 类 技术 
方法 是 未 来 的 趋势 ， 但 无 论 如 何 ， 手 动 的 、 杀 眼 比 对 验证 的 测试 是 无 法 
被 完全 丛 代 的 。 测 试 Web 页 面 的 做 法 通常 是 将 项 目 打包 并 部 车 到 Web 容 
器 中 ， 本 节 介 绍 如 何 使 用 jetty-maven-plugin， 以 使 这 些 步骤 更 为 便捷 。 








在 介绍 jetty-maven-plugin 之 前 ， 笔 者 要 强调 一 点 ， 虽 然 手 动 的 Web 
页 面 测试 是 必 不 可 少 的 ， 但 这 种 方法 绝 不 应 该 被 小 用。 现实 中 常见 的 情 
况 是 ， 很 多 程序 员 即 使 修改 了 一 些 较 底层 的 代码 (如 数据 库 访 问 、 业 务 
逻辑 ) ， 都 会 习惯 性 地 打开 浏览 器 测试 整个 应 用 ， 这 往往 是 没有 必要 
的 。 可 以 用 单元 测试 覆盖 的 代码 就 不 应 该 依赖 于 Web 页 面 测试 ， 且 不 说 
页 面 测试 更 加 耗 时 耗 力 ， 这 种 方式 还 无 法 自动 化 ， 更 别提 重复 性 了 。 因 
此 Web 页 面 测试 应 该 仅 限 于 页 面 的 层次 ， 例 如 JSP、CSS、JavaScript 的 
修改 ， 其 他 代码 修改 “如 数据 访问 ) ， 请 编写 单元 测试 。 

















传统 的 web 测试 方法 要 求 我 们 编译 、 测 试 、 打 包 及 部 署 ， 这 往往 会 
消耗 数 10 秒 至 数 分 钟 的 时 间 ，jetty-maven-plugin 能 够 帮助 我 们 节省 时 


间 ， 它 能 够 周期 性 地 检查 项 目 内 容 ， 发 现 变 更 后 自动 更 新 到 内 置 的 Jetty 
Web art. REW, CARIE THOMAE R. jetty- 
maven-plugin šA WLR bh FF T Maven f H Asai. PEW aT E 
下 ， 我 们 只 需要 直接 在 IDE 中 修改 源码 ，IDE 能 够 执行 目 动 编译 ，jetty- 
maven-plugin 发 现 编译 后 的 文件 变化 后 ， 上 自动 将 其 更 新 到 Jetty 容 器 ， 这 
时 就 可 以 直接 测试 Web 页 面 了 。 





使 用 jetty-maven-plugin 十 分 简单 。 指 定 该 插件 的 坐标 ， 并 且 稍 加 配 
置 即 可 ， 见 代码 清单 12-13。 


代码 清单 12-13 ”配置 jetty-maven-plugin 





<plugin> 


<groupId >org.mortbay. jetty < /groupId > 
<artifactiId >jetty-maven-plugin < /artifactId> 
<version >7,1.6.v20100715 < /version > 

C figurat n 





nintervalSeconds >10 < /scanIntervalSeconds > 


ebAppC q 
<contextPath > /test < /contextPath > 
‘webAppC Fig > 
co igurat 1 


jetty-maven-plugin 并 不 是 官方 的 Maven 插 件 ， 它 的 groupId 是 
org.mortbay.jetty， 上 述 代码 中 使 用 了 Jetty 7 的 最 新 版 本 。 在 该 插件 的 配 
置 中 ，scanIntervalSeconds 顾 名 思 义 表示 该 插件 扫描 项 目 变 更 的 时 间 间 
隅 ， 这 里 的 配置 是 每 阳 10 秒 。 需 要 注意 的 是 ， 如 果 不 进行 配置 ， 该 元 系 
的 默认 值 是 0(， 表 示 不 扫描 ， 用 户 也 就 失去 了 所 谓 的 上 自动 化 热 部 普 的 功 


能 。 上 述 代 码 中 webappConfig 元 素 下 的 contextPath 表 示 项 目 部 团 后 的 
context path。 例 如 这 里 的 值 为 /test， 那 么 用 户 束 可 以 通过 
http://hostname: port/test/ 访 问 该 应 用 。 








下 一 步 启 动 jetty-maven-plugin。 不 过 在 这 之 前 需要 对 settings.xml 做 
个 微小 的 修改 。 前 面 介绍 过 ， 默 认 情 况 下 ， 只 有 
org.apache.maven.plugins 和 org.codehaus.mojo 两 个 groupId 下 的 插件 才 文 


持 简 化 的 命令 行 调用 ， 即 可 以 运行 mvn help: system, {Hmvn jetty: run 





就 不 行 了 。 因 为 maven-help-plugin 的 groupId 是 
org.apache.maven.plugins， 而 jetty-maven-plugin 的 groupId 是 


org.mortbay.jetty。 为 了 能 在 命令 行 直接 运行 mvn jetty: run， 用 户 需 要 配 


置 settings.xml 如 下 : 
<settings > 
<pluginGroups > 
<pluginGroup >org.mortbay. jetty < /pluginGroup > 
< /pluginGroups > 


< / settings > 





现在 可 以 运行 如 下 命令 启动 jetty-maven-plugin: 


jetty-maven-plugin 会 启动 Jetty， 并 且 默 认 监 昕 本 地 的 8080 端 口 ， 并 
将 当前 项 目 部 署 到 容器 中 ， 同 时 它 还 会 根据 用 户 配置 扫描 代码 改动 。 


如 果 和 希望 使 用 其 他 端口 ， 可 以 添加 jetty.port 参 数 。 例 如 : 


现在 就 可 以 打开 浏览 器 通过 地 址 http://localhost: 9999/test/ 测 试 应 用 


了 。 要 停止 Jetty， 只 需要 在 命令 行 输入 Ctrl+C 即 可 。 


局 动 Jetty 之 后 ， 用 户 可 以 在 IDE 中 修改 各 类 文件 ， 如 JSP、HTML、 
CSS、JjJavaScript 甚 至 是 Java 类 。 只 要 不 是 修改 类 名 、 方 法 名 等 较 大 的 操 
作 ，jetty-maven-plugin 都 能 够 扫描 到 变更 并 正确 地 将 变化 更 新 至 Web 容 
器 中 ， 这 无 疑 在 很 大 程度 上 帮助 了 用 户 实现 快速 开发 和 测试 。 

















上 面 的 内 容 仅 仅 展 示 了 jetty-maven-plugin 最 核心 的 配置 点 ， 如 果 有 
需要 ， 还 可 以 自 定义 web.xml 的 位 置 、 项 目 class 文 件 的 位 置 、web 资 源 目 
录 的 位 置 等 信息 。 用 户 还 能 够 以 WAR 包 的 方式 部 署 项 目 ， 甚 至 在 Maven 
的 生命 周期 中 髓 入 jetty-maven-plugin。 例 如 ， 先 启动 Jetty 容 器 并 部 署 项 
目 ， 然 后 执行 一 些 集成 测试 ， 最 后 停止 容器 。 有 兴趣 进一步 研究 的 读者 
可 以 访问 该 页 


面 : http:/wiki.eclipse.org/JettyFeature/Jetty_Maven_Plugin。 





12.5 “使 用 Cargo 实 现 自 动 化 部 署 


Cargo 是 一 组 帮助 用 户 操作 Web 容 器 的 工具 ， 它 能 够 帮助 用 户 实现 
自动 化 部 署 ， 而 且 它 几乎 支持 所 有 的 Web 容 器 ， 如 Tomcat、JBoss、Jetty 
和 Glassfish 等 。Cargo 通 过 cargo-maven2-plugin 提 供 了 Maven 集 成 ， 
Maven 用 户 可 以 使 用 该 插件 将 Web 项 目 部 署 到 Web 容 器 中 。 虽 然 cargo- 
maven2-plugin 和 jetty-maven-plugin 的 功能 看 起 来 很 相似 ， 但 它们 的 目的 
是 不 同 的 ，jetty-maven-plugin 主 要 用 来 帮助 日 常 的 快速 开发 和 测试 ， 而 
cargo-maven2-plugin 主 要 服务 于 目 动 化 部 署 。 例 如 专门 的 测试 人 员 只 圾 
要 一 条 简单 的 Maven 命 令 ， 束 可 以 构建 项 目 并 部 团 到 Web 容 器 中 ， 然 后 
进行 功能 测试 。 本 节 以 Tomcat 6 为 例 ， 介 绍 如 何 自 动 化 地 将 Web 应 用 部 
熙 至 本 地 或 远程 Web 容 器 中 。 


12.5.1 部署 至 本 地 Web 容 器 


Cargo 文 持 两 种 本 地 部 署 的 方式 ， 分 别 为 standalone 模 式 和 existing 模 
式 。 在 standalone 模 式 中 ，Cargo 会 从 Web 容 器 的 安装 目录 复制 一 份 配置 
到 用 户 指定 的 目录 ， 然 后 在 此 基础 上 部 署 应 用 ， 每 次 重新 构建 的 时 候 ， 
这 个 目录 都 会 被 清空 ， 所 有 配置 被 重新 生成 。 而 在 existing 模 式 中 ， 用 户 
需要 指定 现 有 的 Web 容 器 配置 目录 ， 然 后 Cargo 会 直接 使 用 这 些 配置 并 
将 应 用 部 署 到 其 对 应 的 位 置 。 代 码 清单 12-14 展 示 了 standalone 模 式 的 配 
置 样 例 。 











代码 清单 12-14 ”使 用 standalone 模 式 部 署 应 用 至 本 地 Web 容 器 


<plugin > 
<groupid >org. codehaus. cargo < /groupld > 
<artifactId >cargo-maven2-plugin < /artifactId > 
<version >1.0 < /version > 
< configuration > 
<container > 
<containerId >tomcat6x < /containerId > 


<home >D:\cmd \apache-tomcat-6.0.29 < /home > 


< type >standalone < /type > 
<home > $ {project. build. directory}/tomcat6x < /home > 
< /configuration > 
< f/configuration > 
< /plugin> 





cargo-maven2-plugin 的 groupId 是 org.codehaus.cargo， 这 不 属于 官方 
的 两 个 Maven 插 件 groupId， 因 此 用 户 需要 将 其 添加 到 settings.xml 的 


pluginGroup 元 素 中 以 方便 命令 行 调 用 。 


上 述 cargo-maven2-plugin 的 具体 配置 包括 了 container 和 configuration 
两 个 元 素 ，configuration 的 子 元 素 type 表 示 部 署 的 模式 〈 这 里 是 
standalone) 。 与 之 对 应 的 ，configuration 的 home 子 元 素 表示 复制 容器 配 
置 到 什么 位 置 ， 这 里 的 值 为 $ {project.build.directory}/tomcat6x， 表 示 构 
建 输出 日 录 ， 即 target/ 下 的 tomcat6x 子 日 录 。container 元 素 下 的 
containerId 表 示 容 器 的 类 型 ，home 元 素 表示 容器 的 安装 目录 。 基 于 该 配 
置 ，Cargo 会 从 D: cmdvapache-tomcat-6.0.29 目 录 下 复制 配置 到 当前 项 目 
的 target/tomcat6x/ 目 录 下 。 























现在 ， 要 让 Cargo 启 动 Tomcat 并 部 署 应 用 ， 只 需要 运行 : 


S mvn cargo:start 








以 account-web 为 例 ， 现 在 就 可 以 直接 访问 地 址 的 账户 注册 页 面目 


默认 情况 下 ，Cargo 会 让 Web 容 堪 监 听 8080 端 口 。 可 以 通过 修改 
Cargo 的 cargo.servlet.port 属 性 来 改变 这 一 配置 ， 如 代码 清单 12-15 所 示 。 


代码 清单 12-15 ”更改 Cargo 的 Servlet 监 听 端 口 


<plugin > 
<groupid >org. codehaus. cargo < /groupId > 
<artifactid >cargo-maven2-plugin< /artifactiId> 
<version >1.0 < /version> 
< configuration > 
<container > 
<containerid >tomcat6x < /container > 
<home >D:\cmd \apache-tomcat-—6.0.29 < /home > 
< /container > 
<configuration > 
< type >standalone< /type > 
<home > $ {project. build. directory}/tomcat6x < /home > 
<properties > 
<cargo. servlet. port >8081 < /cargo. serviet.port > 
< /properties > 
< /configuration > 
< /configuration > 
< /plugin > 





要 将 应 用 直接 部 署 到 现 有 的 Web 容 器 下 ， 需 要 配置 Cargo 使 用 
existing 模 式 ， 如 代码 清单 12-16 所 示 。 


代码 清单 12-16 ”使 用 existing 模 式 部 和 获 应 用 至 本 地 Web 容 器 


<plugin > 
<groupId >org. codehaus. cargo < /groupId > 
<artifactid >cargo-maven2-plugin < /artifactId > 
<version >1.0 < /version> 
< configuration > 
<container > 
<containerid >tomcat6x < /containerId > 
<home >D: \cmd \apache-tomcat-6.0.29 < /home > 
< /container > 
< configuration > 
<type >existing < /type > 
<home > D: \cmd \apache-tomcat-6.0.29 < /home > 
< /configuration > 
< f/configuration > 
< /plugin > 


上 述 代码 中 configuration 元 素 的 type 子 元 素 的 值 为 existing， 而 对 应 
的 home 子 元 素 表 示 现 有 的 Web 容 器 目录 ， 基 于 该 配置 运行 mvn cargo: 
start 之 后 ， 便 能 够 在 Tomcat 的 webapps 子 目录 看 到 被 部 署 的 Maven 项 目 。 











[1] 地 址 为 http:localhost: 8080/account-web-1.0.0- 
SNAPSHOT/signup.jsp。 


12.5.2 ”部 署 至 远程 Web 容 器 


除了 让 Cargo 直 接管 理 本 地 Web 容 融 然 后 部 普 应 用 之 外 ， 也 可 以 让 
Cargo 部 普 应 用 至 远程 的 正在 运行 的 Web 容 髓 中 。 当 然 ， 前 提 是 拥有 该 
容器 的 相应 管理 员 权 限 。 相 关 配 置 如 代码 清单 12-17 所 示 。 





代码 清单 12-17 部 署 应 用 至 远程 Web 容 器 


<plugin > 
<groupld >org. codehaus. cargo < /groupId > 
<artifactId >cargo-maven2-plugin < /artifactId > 
<version >1.0 < /version > 
< configuration > 
<container > 
<containerlId >tomcat6x < /containerId > 
< type > remote < /type > 
< f/container > 
< configuration > 
< type > runtime < /type > 
<properties > 
< cargo. remote. username >admin < /cargo. remote. username > 
< cargo. remote. password > admini23 < /cargo. remote. password > 
<cargo. tomcat.manager.url >http://localhost :8080 /manager < /car- 
go. tomcat.manager.url > 
< /properties > 
< /configuration > 


< /configuration > 


< /plugin > 


对 于 远程 部 署 的 方式 来 说 ，container 元 素 的 type 子 元 素 的 值 必须 为 
remote。 如 条 不 显 式 指定 ，Cargo 会 使 用 默认 值 installed， 并 寻找 对 应 的 
容器 安装 目录 或 者 安装 包 ， 对 于 远程 部 署 方式 来 说 ， 安 装 目录 或 者 安装 
包 是 不 需要 的 。 上 述 代 码 中 configuration 的 type 子 元 素 值 为 runtime， 表 
示 既 不 使 用 独立 的 容器 配置 ， 也 不 使 用 本 地 现 有 的 容器 配置 ， 而 是 依赖 

















于 一 个 已 运行 的 容器 。properties 元 系 用 来 声明 一 些 容 需 热 部 着 相关 的 配 
置 。 例 如 ， 这 里 的 Tomcat 6 就 再 要 提供 用 户 名 、 密 码 以 及 管理 地 址 。 需 
要 注意 的 是 ， 这 部 分 配置 元 素 对 于 所 有 容器 来 说 不 是 一 致 的 ， 读 者 需要 
查阅 对 应 的 Cargo 文 档 。 








有 了 上 述 配 置 后 ， 就 可 以 让 Cargo 部 署 应 用 了 。 运 行 命令 如 下 : 


S mvn cargo:redeploy 





WR Aas FOAMS SSAA, Cargosss7cKt el ax, A Ja Fh ae 
DERE o 








FH Aa al AS yt AN ee fd INST, «FEE Cargo ak 4 FH 
不 同类 型 的 web 容 器， 因此 cargo-maven2-plugin 的 相关 配置 会 显得 相对 
复杂 ， 这 个 时 候 完 善 的 文档 就 显得 尤为 重要 。 如 果 想 进一步 了 解 


Cargo， 可 访问 http://cargo.codehaus.org/Maven2+plugin。 








12.6 小结 


本 章 介绍 的 是 用 Maven 管 理 Web 项 目 ， 因 此 首先 讨论 了 Web 项 目的 
基本 结构 ， 然 后 分 析 实 现 了 本 书 背景 案例 的 最 后 两 个 模块 : account- 
service 和 account-web， 其 中 后 者 是 一 个 典型 的 Web 模 块 。 开 发 Web 项 目 
WA 
plugin 可 以 帮助 实现 这 一 目标 。 本 章 最 后 讨论 的 是 自动 化 部 署 ， 这 一 技 
术 的 主角 是 Cargo， 有 了 它 ， 可 以 让 Maven 目 动 部 署 应 用 至 本 地 和 远程 


Web 容 器 中 。 


第 13 章 ”版 本 管理 


` 何 为 版 本 管理 
-Maven 的 版 本 号 定义 约定 
主干 、 标 签 与 分 支 
-自动 化 版 本 发 布 
自动 化 创建 分 支 

-GPG 签名 

:小结 


一 个 健康 的 项 目 通 常 有 一 个 长 期 、 合 理 的 版 本 演变 过 程 。 例 如 JUnit 
有 3.7、3.8、3.8.1、3.8.2、4.0、4.1 等 版 本 。Maven 本 身 的 版 本 也 比较 
多 ， 如 最 早 的 Maven 1; 目前 使 用 最 广泛 的 Maven 2 有 2.0.9、2.0.10、 
2.1.0、2.2.0、2.2.1 等 各 种 版 本 ; 而 最 新 的 Maven 3 则 拥有 3.0-alpha-1、 
3.0-alpha-2、3.0-alpha-7、3.0-beta-1 等 版 本 。 除 了 这 些 对 外 发 布 的 版 本 
之 外 ，6.5 节 还 介绍 了 Maven 特 有 的 快照 版 本 的 概念 。 这 些 版 本 中 的 每 个 
数字 代表 了 什么 ? alpha、beta 是 什么 意思 ? 快照 版 和 发 布 版 的 区 别 是 什 








么 ? 我 们 应 该 如 何 科学 地 管理 自己 的 项 目 版 本 ? 本 章 将 会 详细 解答 这 些 


问题 。 


阅读 本 章 的 时 候 还 需要 分 清 版 本 管理 (Version Management) 和 版 
本 控制 (Version Control) 的 区 别 。 版 本 管理 是 指 项 目 整体 版 本 的 演变 
过 程 管理 ， 如 从 1.0-SNAPSHOT 到 1.0， 再 到 1.1-SNAPSHOT。 版 本 控制 
是 指 借助 版 本 控制 工具 〈 如 Subversion) 追踪 代码 的 每 一 个 变更 。 本 章 
重点 讲述 的 是 版 本 管理 ， 但 是 读者 将 会 看 到 ， 版 本 管理 通常 也 会 涉及 一 
些 版 本 控制 系统 的 操作 及 概念 。 请 在 阅读 的 时 候 特 别 留意 这 两 者 的 关系 
和 区 别 。 














13.1 何 为 版 本 管理 





6.5 节 谈 到 ， 为 了 方便 团队 的 合作 ， 在 项 目 开 发 的 过 程 中 ， 大 家 都 
应 该 使 用 快照 版 本 ，Maven 能 够 很 智能 地 处 理 这 种 特殊 的 版 本 ， 解 析 项 
目 各 个 模块 最 新 的 “快照 ?>。 快 照 版 本 机 制 促进 团队 内 部 的 交流 ， 但 是 当 
项 目 需要 对 外 发 布 时 ， 我 们 显然 需要 提供 非常 稳定 的 版 本 ， 使 用 该 版 本 
应 当 永 远 只 能 够 定位 到 唯一 的 构件 ， 而 不 是 像 快照 版 本 那样 ， 定 位 的 构 
件 随 时 可 能 发 生变 化 。 对 应 地 ， 我 们 称 这 类 稳定 的 版 本 为 发 布 版 。 项 目 
发 布 了 一 个 版 本 之 后 ， 束 进入 下 一 个 开发 阶段 ， 项 目 也 就 自然 转 换 到 新 
的 快照 版 本 中 。 





版 本 管理 关心 的 问题 之 一 就 是 这 种 快照 版 和 发 布 版 之 间 的 转换 。 项 
目 经 过 了 一 段 时 间 的 1.0-SNAPSHOT 的 开发 之 后 ， 在 某 个 时 刻 发 布 了 1.0 
正式 版 ， 然 后 项 目 又 进入 了 1.1-SNAPSHOT 的 开发 ， 这 个 版 本 可 能 添加 
了 一 些 有 趣 的 特性 ， 然 后 在 某 个 时 刻 发 布 1.1 正 式 版 。 项 目 接着 进入 1.2- 
SNAPSHOT 的 开发 。 由 于 快照 对 应 了 项 目的 开发 过 程 ， 因 此 往往 对 应 了 
很 长 的 时 间 ， 而 正式 版 本 对 应 了 项 目的 发 布 ， 因 此 仅仅 代表 某 个 时 刻 项 
目的 状态 ， 如 图 13-1 所 示 。 











图 13-1 快照 版 和 发 布 版 之 间 的 转换 


理想 的 发 布 版 本 应 当 对 应 了 项 目 某 个 时 刻 比 较 稳 定 的 状态 ， 这 包括 
源 代 码 的 状态 以 及 构建 的 状态 ， 因 此 这 个 时 候 项 目的 构建 应 当 满 足以 下 
NATE: 


“所 有 上 自动 化 测试 应 当 全 部 通过 。 坚 无 疑问 ， 失 败 的 测试 代表 了 项 
要 修复 的 问题 ， 因 此 发 布 版 本 之 前 应 该 确保 所 有 测试 都 能 得 以 正确 执 


/一 


介 。 





项 目 没有 配置 任何 快照 版 本 的 依赖 。 快 照 版 本 的 依赖 意味 着 不 同 
时 间 的 构建 可 能 会 引入 不 同 内 容 的 依赖 ， 这 显然 不 能 保证 多 次 构建 能 够 
生成 同样 的 结果 。 


:项 目 没 有 配置 任何 快照 版 本 的 插件 。 快 照 版 本 的 插件 配置 可 能 会 
在 不 同时 间 引 入 不 容 内 容 的 Maven 插 件 ， 从 而 影响 Maven 的 行为 ， 破 坏 
构建 的 稳定 性 。 





项 目 所 包含 的 代码 已 经 全 部 提交 到 版 本 控制 系统 中 。 项 目 已 经 发 
布 了 ， 可 源 代码 却 不 在 版 本 控制 系统 中 ， 甚 至 丢失 了 。 这 意味 着 项 目 丢 
失 了 茶 个 时 刻 的 状态 ， 因 此 这 种 情况 必须 避免 ， 版 本 发 布 的 时 候 必 须 确 
保 所 有 的 源 代 码 都 已 经 提交 了 。 





只 有 上 述 条 件 都 满足 之 后 ， 才 可 以 将 快照 版 本 更 新 为 发 布 版 本 ， 例 
如 将 1.0-SNAPSHOT 更 新 为 1.0， 然 后 生成 版 本 为 1.0 的 项 目 构件 。 


不 过 这 里 还 缺少 一 步 关键 的 版 本 控制 操作 。 如 果 你 了 解 任何 一 种 版 
本 控制 工具 ， 如 Subversion， 那 就 应 该 能 想到 项 目 发 布 与 标签 (Tag) 的 
关系 。 版 本 控制 系统 记录 代码 的 每 一 个 变化 ， 通 常 这 些 变化 都 被 维护 在 
EF (Trunk) 中 ， 但 是 当 项 目 发 布 的 时 候 ， 开 发 人 员 就 应 该 使 用 标签 
记录 这 一 特殊 时 刻 项 目的 状态 。 以 Subversion 为 例 ， 日 常 的 变更 维护 在 
主干 中 ， 包 含 各 种 源码 版 本 r1、r2、...、r284、...。 要 找到 某 个 时 刻 的 
项 目 状 态 会 比较 麻烦 ， 而 使 用 标签 就 可 以 明确 地 将 某 个 源码 版 本 也 就 
是 项 目 状态 ) 从 主干 中 标记 出 来 ， 放 到 单独 的 位 置 ， 这 样 在 之 后 的 任何 
时 刻 ， 我 们 都 能 够 快速 地 得 到 发 布 版 本 的 源 代码 ， 从 而 能 够 比较 各 个 版 
本 的 差异 ， 甚 至 重新 构建 一 个 同样 版 本 的 构件 。 








因此 ， 将 项 目的 快照 版 本 更 新 至 发 布 版 本 之 后 ， 应 当 再 执行 一 次 
Maven 构 建 ， 以 确保 项 目 状 态 是 健康 的 。 然 后 将 这 一 变更 提交 到 版 本 控 
制 系统 的 主干 中 。 接 着 再 为 当前 主干 的 状态 打上 标签 。 以 Subversion 为 
例 ， 这 几 个 步骤 对 应 的 命令 如 下 : 











至 此 ， 一 个 版 本 发 布 的 过 程 完成 了 。 接 下 来 要 做 的 就 是 更 新 发 布 版 
本 至 新 的 快照 版 本 ， 如 从 1.0 到 1.1-SNAPSHOT。 


13.2 ”Maven 的 版 本 号 定义 约定 


到 目前 为 止 ， 读 者 应 该 已 经 清楚 了 解 了 快照 版 和 发 布 版 的 区 别 。 现 
在 再 深入 看 一 下 1.0、1.1、1.2.1、3.0-beta 这 样 的 版 本 号 后 面 又 遵循 了 怎 
样 的 约定 。 了 解 了 这 样 的 约定 之 后 ， 就 可 以 正确 地 为 自己 的 产品 或 者 项 
目 定义 版 本 号 ， 而 你 的 用 户 也 能 了 解 到 隐藏 在 版 本 号 中 的 信息 。 














看 一 个 实际 的 例子 ， 这 里 有 一 个 版 本 : 
1.3.4-beta-2 
这 往往 表示 了 该 项 目 或 产品 的 第 一 个 重大 版 本 的 第 三 个 次 要 版 本 的 
第 四 次 增 量 版 本 的 beta-2 里 程 碑 。 很 抛 口 ? 那 一 个 个 分 开 解 释 :“1” 表 示 
了 该 版 本 是 第 一 个 重大 版 本 ; “3” 表 示 这 是 基于 重大 版 本 的 第 三 个 次 要 
版 本 ; “4” 表 示 该 次 要 版 本 的 第 四 个 增 量 ， 最 后 的 “beta-2” 表 示 该 增 量 的 


某 一 个 里 程 碑 。 


也 就 是 说 ，Maven 的 版 本 号 定义 约定 是 这 样 的 : 





< 主 版 本 >.< 次 版 本 >.< 增 量 版 本 >-< 里 程 碑 版 本 > 








主 版 本 和 次 版 本 之 间 ， 以 及 次 版 本 和 增 量 版 本 之 间 用 点 号 分 隔 ， 里 
程 碑 版 本 之 前 用 连 字号 分 隔 。 下 面 解释 其 中 每 一 个 部 分 的 意义 : 





ERA: 表示 了 项 目的 重大 架构 变更 。 例 如 ，Maven 2 和 Maven 1 
相去 甚 远 ; Struts 1 和 Struts 2 采用 了 不 同 的 架构 ; JUnit 4 较 JUnit 3 增加 了 
标注 文 持 。 


:次 版 本 : 表示 较 大 范围 的 功能 增加 和 变化 ， 及 Bug 修 复 。 例 如 
Nexus 1.5 较 1.4 添 加 了 LDAP 的 文 持 ， 并 修复 了 很 多 Bug， 但 从 总 体 架 构 
来 说 ， 没 有 什么 变化 。 


: 增 量 版 本 : 一 般 表示 重大 Bug 的 修复 ， 例 如 项 目 发 布 了 1.4.0 版 本 之 
后 ， 发 现 了 一 个 影响 功能 的 重大 Bug， 则 应 该 快速 发 布 一 个 修复 了 Bug 
的 1.4.1 版 本 。 


:里程碑 版 本 : 顾名思义 ， 这 往往 指 某 一 个 版 本 的 里 程 碑 。 例 如 ， 
Maven 3 已 经 发 布 了 很 多 里 程 碑 版 本 ， 如 3.0-alpha-1、3.0-alpha-2、3.0- 
beta-1 等 。 这 样 的 版 本 与 正式 的 3.0 相 比 ， 往 往 表 示 不 是 非常 稳定 ， 还 需 
要 很 多 测试 。 





再 要 注意 的 是 ， 不 是 每 个 版 本 号 都 必须 拥有 这 四 个 部 分 。 一 般 来 
说 ， 主 版 本 和 次 版 本 都 会 声明 ， 但 增 量 版 本 和 里 程 碑 就 不 一 定 了 。 例 
如 ， 像 3.8 这 样 的 版 本 没有 增 量 和 里 程 碑 ，2.0-beta-1 没 有 增 量 。 但 我 们 
不 会 看 到 有 人 省 略 次 版 本 ， 简 单 地 给 出 主 版 本 显然 是 不 够 的 。 














当 用 户 在 声明 依赖 或 插件 未 声明 版 本 时 ，Maven 束 会 根据 上 述 的 版 
本 号 约定 自动 解析 最 新 版 本 。 这 个 时 候 就 需要 对 版 本 号 进行 排序 。 对 于 











主 版 本 、 次 版 本 和 增 量 版 本 来 说 ， 比 较 是 基于 数字 的 ， 因 此 
1.5>1.4>1.3.11>1.3.9。 而 对 于 里 程 碑 版 本 ，Maven 则 只 进行 简单 的 字符 


串 比 较 ， 因 此 会 得 到 1.2-beta-3>1.2-beta-11 的 结果 。 这 一 点 需要 留意 。 


13.3 主干、 标签 与 分 支 


使 用 版 本 控制 工具 时 我 们 都 会 允 到 主干 (trunk) 、 标 签 (tag) 和 
branch (分 支 ) 的 概念 。13.1 节 已 经 涉及 了 主干 与 标签 。 这 里 再 详细 将 
这 几 个 概念 曾 述 一 下 ， 因 为 理解 它们 是 理解 Maven 版 本 管理 的 基础 。 


ET: 项 目 开发 代码 的 主体 ， 是 从 项 目 开 始 直到 当前 都 处 于 活动 
的 状态 。 从 这 里 可 以 获得 项 目 最 新 的 源 代 码 以 及 几乎 所 有 的 变更 历史 。 











分 文 : 从 主干 的 茶 个 点 分 离 出 来 的 代码 找 贝 ， 通 冲 可 以 在 不 影响 
主干 的 前 提 下 在 这 里 进行 重大 Bug 的 修复 ， 或 者 做 一 些 实验 性 质 的 开 
发 。 如 果 分 文 达 到 了 预期 的 目的 ， 通 第 发 生 在 这 里 的 变更 会 被 合并 

(merge) 到 主干 中 。 


标签 : 用 来 标识 主干 或 者 分 支 的 某 个 点 的 状态 ， 以 代表 项 目的 茶 
个 稳定 状态 ， 这 通 向 就 是 版 本 发 布 时 的 状态 。 








本 书 采用 Subversion 作 为 版 本 控制 系统 ， 如 果 对 上 述 概念 不 清晰 ， 
请 参考 开放 的 《Subversion 与 版 本 控制 》 Chttp://svnbook.red- 
bean.com/) 一 书 。 


使 用 Maven 管 理 项 目 版 本 的 时 候 ， 也 涉及 了 很 多 的 版 本 控制 系统 操 
作 。 下 面 束 以 一 个 实际 的 例子 来 介绍 这 些 操作 是 如 何 执 行 的 。 








图 13-2 下 方 最 长 的 箭头 表示 项 目的 主干 ， 项 目 最 初 的 版 本 是 1.0.0- 
SNAPSHOT， 经 过 一 段 时 间 的 开发 后 ，1.0.0 版 本 发 布 ， 这 个 时 候 就 需要 
打 一 个 标签 ， 图 中 用 一 个 长 条 表示 。 然 后 项 目 进 入 1.1.0-SNAPSHOT 状 
态 ， 大 量 的 开发 工作 都 完成 在 主干 中 ， 添 加 了 一 些 新 特性 并 修复 了 很 多 
Bug 之 后 ， 项 目 1.1.0 发 布 ， 同 样 ， 这 时 候 需要 打 另 一 个 标签 。 发 布 过 
后 ， 项 目 进 入 1.2.0-SNAPSHOT 阶 段 ， 可 这 个 时 候 用 户 报告 1.1.0 版 本 有 
一 个 重大 的 Bug， 需 要 尽快 修复 ， 我 们 不 能 在 主干 中 修 Bug， 因 为 主干 
有 太 多 的 变化 ， 无 法 在 短 时 间 内 测试 完毕 并 发 布 ， 我 们 也 不 能 停止 
1.2.0-SNAPSHOT 的 开发 ， 因 此 这 时 候 可 以 基于 1.1.0 创 建 一 个 1.1.1- 
SNAPSHOT 的 分 文 ， 在 这 里 进行 Bug 修 复 ， 然 后 为 用 户 发 布 一 个 1.1.1 增 
量 版 本 ， 同 时 打上 标签 。 当 然 ， 还 不 能 忘 了 把 Bug 修 复 涉及 的 变更 合并 
到 1.2.0-SNAPSHOT 的 主干 中 。 主 干 在 开发 一 段 时 间 之 后 ， 发 布 1.2.0 版 
本 ， 然 后 进入 到 新 版 本 1.3.0-SNAPSHOT 的 开发 过 程 中 。 














1.0.0-SNAPSHOT 1.1.0-SNAPSHOT 1.2.0-SNAPSHOT 1.3.0-SNAPSHOT 


图 13-2 主干、 标签 和 分 支 与 项 目 版 本 的 关系 


图 13-2 展 示 的 是 一 个 典型 的 项 目 版 本 变化 过 程 ， 这 里 涉及 了 快照 版 
与 发 布 版 之 间 的 切换 、Maven 版 本 号 约定 的 应 用 ， 以 及 版 本 控制 系统 主 
干 、 标 签 和 分 支 的 使 用 。 这 其 实 也 是 一 个 不 成 文 的 行业 标准 ， 理 解 这 个 
过 程 之 后 ， 不 仅 能 够 更 方便 地 学 习 开 源 项 目 ， 也 能 对 项 目的 版 本 管理 更 
加 标准 和 清晰 。 





13.4 目 动 化 版 本 发 布 





本 章 前 几 节 已 经 详细 介绍 了 版 本 发 布 时 所 需要 完成 的 工作 ， 读 者 如 
果 愿 意 ， 则 完全 可 以 手动 地 执行 这 些 操作 ， 检 查 是 否 有 未 提交 代码 、 是 
人 否 有 快照 依赖 、 更 新 快照 版 至 友 布 版 、 执 行 Maven 构 建 以 及 为 源 代码 打 
标签 等 。 事 实 上 ， 如 果 对 这 一 过 程 不 是 很 熟悉， 那么 还 是 应 该 一 步 一 步 
地 操作 一 过 ， 以 得 到 最 直观 的 感受 。 











当 熟 悉 了 版 本 及 布 流程 之 后 ， 就 会 布 望 借助 工具 将 这 一 流程 目 动 
化 。Maven Release Plugin 束 提供 了 这 样 的 功能 ， 只 要 提供 一 些 必要 的 信 
恩 ， 它 就 能 帮 我 们 完成 上 述 所 有 版 本 发 布 所 涉及 的 操作 。 下 面 介绍 如 何 
使 用 Maven Release Plugin 发 布 项 目 版 本 。 


Maven Release Plugin 主 要 有 三 个 目标 ， 它 们 分 别 为 : 


‘release: prepare 准 备 版 本 发 布 ， 依 次 执行 下 列 操作 : 





四 检查 项 目 是 否 有 未 提交 的 代码 。 





四 检查 项 目 是 否 有 快照 版 本 依赖 。 





四 根据 用 户 的 输入 将 快照 版 本 升级 为 发 布 版 。 


四 将 POM 中 的 SCM 信 息 更 新 为 标签 地 址 。 


四 基于 修改 后 的 POM 执 行 Maven 构 建 。 
四 提交 POM 变 更 。 

@ 基 于 用 户 输 入 为 代码 打 标 签 。 

四 将 代码 从 发 布 版 升级 为 新 的 快照 版 。 
四 提交 POM 变 更 。 


‘release: rollback 回 退 release: prepare 所 执行 的 操作 。 将 POM 回 退 
至 release: prepare 之 前 的 状态 ， 并 提交 。 需 要 注意 的 是 ， 该 步骤 不 会 删 


除 release: prepare 生 成 的 标签 ， 因 此 用 户 需 要 手动 删除 。 


‘release: perform 执 行 版 本 发 布 。 签 出 release: prepare 生 成 的 标签 中 
的 源 代 码 ， 并 在 此 基础 上 执行 mvn deploy 命 令 打包 并 部 署 构件 至 仓库 。 





要 为 项 目 发 布 版 本 ， 首 先 需要 为 其 添加 正确 的 版 本 控制 系统 信息 ， 
这 是 因为 Maven Release Plugin 需 要 知道 版 本 控制 系统 的 主干 、 标 签 等 地 
址 信息 后 才能 执行 相关 的 操作 。 一 般配 置 项 目的 SCM 信 息 如 代码 清单 
13-1 所 示 。 


代码 清单 13-1 为 版 本 发 布 配置 SCM 信 息 


<project > 


< scm > 


<connection >scm:svn:http://192.168.1.103 /app/trunk < /connection > 





<developerConnection >scm:svn:https ://192.168.1.103 /app/trunk < /developerCon- 


<url> http://192.168.1.103 /account /trunk < /url > 
‘scm 
roject 


代码 清单 13-1 中 的 connection 元 素 表 示 一 个 只 读 的 scm 地 址 ， 而 
developerConnection 元 素 表 示 可 写 的 scm 地 址 ，url 则 表示 可 以 在 浏览 器 
中 访问 的 scm 地 址 。 为 了 能 让 Maven 识 别 ，connection 和 
developerConnection 必 须 以 scm 开 涉 ， 冒 号 之 后 的 部 分 表示 版 本 控制 工具 
类 型 (这 里 是 syn) ，Maven 还 文 持 cvs、git 等 。 接 下 来 才 是 实际 的 scm 地 
址 ， 该 例 中 的 connection 使 用 了 http 协 议 ， 而 developerConnection 则 由 于 
涉及 写 操作 ， 使 用 https 协 议 进行 了 保护 。 











该 配置 只 告诉 Maven 当 前 代码 的 位 置 〈 主 干 ) ， 而 版 本 发 布 还 要 涉 
及 标签 操作 。 因 此 ， 还 需要 配置 Maven Release Plugin 告 诉 其 标签 的 基础 


目录 ， 如 代码 清单 13-2 所 示 。 





代码 清单 13-2 ”配置 maven-release-plugin 提 供 标 签 基 础 目录 








org. apache. maven. plugins < /9roupIG > 


sn-release-plugin < /artifactId> 





<version >2.0 </version> 
figuration > 


<tagBase >https://192.168.1.103 /app/tags/< /tagBase > 


在 执行 release: prepare 之 前 还 有 两 个 注意 点 : 第 一 ， 系 统 必 须要 提 
供 svn 命 令 行 工 具 ，Maven 需 要 svn 命 令 行 工 具 执 行 相关 操作 ， 而 无 法 使 
用 图 形 化 的 工具 ， 如 TortoiseSVN; 第 二 ，POM 必 须 配置 了 可 用 的 部 署 
仓库 ， 因 为 release: perform 会 执行 deploy 操 作 将 构件 发 布 到 仓库 中 。 关 
于 如 何 配 置 部 蜀 仓 库 可 参考 9.6.1 市 。 











一 切 就 绪 之 后 ， 在 项 目 根 目 录 下 运行 如 下 命令 


$mvn release:prepare 


Maven Release Plugin 开 始 准 备 发 布 版 本 ， 如 果 它 检测 到 项 目 有 未 提 
交 的 代码 ， 或 者 项 目 有 快照 版 的 依赖 ， 则 会 提示 出 错 。 如 果 一 切 都 没 问 
题 ， 则 会 提示 用 户 输入 想 要 发 布 的 版 本 号 、 标 签 的 名 称 以 及 新 的 快照 版 
本 号 。 例 如 : 


What is the release version for "App"? Gom, J D) Rete £ 
What is SCM relea ag or label for "App p" iias ju 00k :app) app-1.0.0: : 
What is the new deve ef ment version for " "ADD a2 isu. juvenxu.mvnbook:app) 1.0.1- 
SNAPSHOT: :1.1. 0 -SNAPSHOT 





如 果 项 目的 artifactId 为 app， 人 发 布衣 的 版 本 为 1.0.0-SNAPSHOT， 则 
Maven Release Plugin 会 提示 使 用 发 布 版 本 号 1.0.0， 使 用 标签 名 称 app- 
1.0.0， 新 的 开发 版 本 为 1.0.1-SNAPSHOT。 如 果 这 些 模 式 值 正 是 你 想 要 
的 ， 直 接 按 Enter 键 即 可 ， 人 否则 就 输入 想 要 的 值 再 按 Enter 键 ， 如 上 例 中 
为 新 的 开发 版 本 输入 了 值 1.1.0-SNAPSHOT。 


基于 这 些 信息 ，Maven Release Plugin 会 将 版 本 从 1.0.0-SNAPSHOT 


更 新 为 1.0.0， 并 更 新 SCM 地 址 http:/192.168.1.103/appytrunk 至 
http://192.168.1.103/app/tags/app-1.0.0。 在 此 基础 上 运行 一 次 Maven 构 建 
以 防止 意外 的 错误 出 现 ， 然 后 将 这 两 个 变化 提交 ， 并 为 该 版 本 打上 标 
签 ， 标 签 地 址 是 http://192.168.1.103/app/tags/app-1.0.0。 即 tagBase 路 径 加 
上 标签 名 称 。 之 后 ，Maven Release Plugin 会 将 POM 中 的 版 本 信息 从 1.0.0 


升级 到 1.1.0-SNAPSHOT 并 提交 。 


至 此 ，release: prepare 的 工作 完成 。 如 果 这 时 你 发 现 了 一 些 问题 ， 
例如 将 标签 名 称 配 置 错 了 ， 则 可 以 使 用 release: rollback 命 令 回 退 发 布 ， 
Maven Release Plugin 会 将 POM 的 配置 回 退 到 release: prepare 之 前 的 状 
态 。 但 需要 注意 的 是 ， 版 本 控制 系统 中 的 标签 并 不 会 被 删除 ， 也 就 是 
说 ， 用 户 需 要 手动 执行 版 本 控制 系统 命令 删除 该 标签 。 








在 多 模块 项 目 中 执行 release: prepare 的 时 候 ， 默 认 maven-release- 
plugin 会 提示 用 户 设 定 每 个 模块 发 布 版 本 号 及 新 的 开发 版 本 写 。 例 如 ， 
如 果 在 account-parent 模 块 中 配置 正确 的 scm 信 息 之 后 进行 项 目 发 布 ， 就 
会 看 到 如 下 的 输出 : 





What is the release version for "Account Parent"? (com. juvenxu.mvnbook. account: 
account—parent) 1.0.0: : 

What is the release version for "Account Email"? (com. juvenxu. mvnbook. account :ac- 
count-email) 1.0.0: : 

What is the release version for "Account Persist"? (com. juvenxu.mvnbook. account: 
account-persist) 1.0.0: : 

What is the release version for "Account Captcha"? (com. juvenxu.mvnbook. account : 
account-captcha)1.0.0:: 

What is the release version for "Account Service"? (com. juvenxu.mvnbook. account: 
account-service) 1.0.0: : 

What is the release version for "Account Web"? (com. juvenxu.mvnbook. account :ac- 
count-web) 1.0.0:: 

What is SCM release tag or label for “Account Parent"? (com. juvenxu.mvnbook. account :ac- 
count-parent) account-parent-1.0.0:: 

What is the new development version for "Account Parent"? (com. juvenxu.mvnbook. account : 
account—parent) 1.0.1-SNAPSHOT: : 

What is the new development version for "Account Email"? (com. juvenxu.mvnbook. account: 
account-email) 1.0.1-SNAPSHOT: : 

What is the new development version for "Account Persist"? (com. juvenxu.mvnbook. account: 
account-persist) 1.0.1—-SNAPSHOT: : 

What is the new development version for "Account Captcha"? (com. juvenxu.mvnbook. account : 
account-captcha) 1.0.1-SNAPSHOT: : 

What is the new development version for "Account Service"? (com. juvenxu.mvnbook. account: 
account-service) 1.0.1-SNAPSHOT: : 

What is the new development version for "Account Web"? (com. juvenxu. mvnbook. account :ac- 
count—web) 1.0.1-SNAPSHOT: : 


在 很 多 情况 下 ， 我 们 会 希望 所 有 模块 的 发 布 版 本 以 及 新 的 
SNAPSHOT 开 发 版 本 都 保持 一 致 。 为 了 避免 重复 确认 ，maven-release- 
plugin 提 供 了 autoVersionSubmodules 参 数 。 例 如 运行 下 面 的 命令 后 ， 
maven-release-plugin 就 会 自动 为 所 有 子 模 块 使 用 与 父 模块 一 致 的 发 布 版 
本 和 新 的 SNAPSHOT 版 本 : 


Smvn release:prepare DautoVersionSubmodules =true 


如 果 检 查 下 来 release: prepare 的 结果 没有 问题 ， 标 签 和 新 的 开发 版 
本 都 是 正确 的 ， 可 以 执行 如 下 友 布 执行 命令 : 


$mvn release:perform 


该 命令 将 标签 中 的 代码 签 出 ， 执 行 mvn deploy 命 令 构 建 刚才 准备 的 
1.0.0 版 本 ， 并 部 署 到 仓库 中 。 至 此 ， 版 本 1.0.0 正 式 发 布 完成 。 由 于 它 已 
经 被 部 署 到 了 Maven 仓 库 中 ， 其 他 人 可 以 方便 地 配置 对 它 的 依赖 。 


细心 的 读者 可 能 会 发 现 ， 如 果 你 所 发 布 项 目的 打包 类 型 为 jar， 在 执 
行 release: perform 之 后 ， 不 仅 项 目的 主 构件 会 被 生成 并 发 布 到 仓库 中 ， 
基于 该 主 构件 的 -sources.jar 和 -javadoc.jar 也 会 生成 并 发 布 。 对 于 你 的 用 
户 来 说 ， 这 无 疑 是 非常 方便 的 ， 他 们 不 仅 能 够 下 载 你 的 主 构件 ， 还 能 够 
得 到 项 目的 源码 和 Javadoc。 那 么 ，release: perform 是 怎样 生成 - 





sources.jar 和 -javadoc.jar 的 呢 ? 


8.5 节 介绍 过 ， 所 有 Maven 项 目的 POM 都 继承 自 超 级 POM， 而 如 果 
打开 超级 POM， 束 能 发 现 如 代码 清单 13-3 所 示 内 容 。 


代码 清单 13-3 ”超级 PZOM 中 sources 和 javadoc 的 配置 


<profiles > 
<profile> 
<id>release-profile< /id> 


<activation> 
<property > 
<name >performRelease < /name > 
<value >true < /value > 
< /property > 
< /activation > 


<build> 
<plugins > 
<plugin > 
<inherited >true < /inherited> 
<artifactId >maven-source-plugin < /artifactiId> 
< executions > 
<execution > 
<id>attach-sources < /id> 
<goals > 
<goal >jar < /goal > 
< /goals > 
< /execution > 
< /executions > 
</plugin> 
<plugin> 
<inherited >true < /inherited> 
<artifactId >maven-javadoc-plugin < /artifactId > 
< executions > 
< execution > 
<id>attach-javadocs < /id> 
<goals > 
<goal >jar < /goal > 
< /goals > 
< f/execution > 
< /executions > 
</plugin > 
<plugin > 
< inherited >true < /inherited > 
<artifactId >maven-deploy-—plugin < /artifactId > 
< configuration > 
<updateReleaselnfo >true < /updateReleaselInfo > 
< /configuration > 
< /plugin > 
< /plugins > 
</build> 
< /profile> 
< /profiles > 


超级 POM 中 定义 了 一 个 名 为 release-profile 的 Maven Profile, 


Profile 


是 指 一 段 在 特定 情况 下 被 激活 并 更 改 Maven 行 为 的 配置 ， 本 书后 续 会 有 
专门 的 章节 详细 阐述 。 这 里 看 到 activate 元 素 下 有 一 个 名 为 
performRelease、 值 为 true 的 属性 配置 ， 这 表示 当 Maven 运 行 时 ， 如 果 运 
行 环境 中 有 performRelease 属 性 且 值 为 true 的 时 候 ， 该 Profile 就 被 激活 。 
也 就 是 说 ， 该 Profile 下 的 配置 会 得 到 应 用 。 那 么 ， 什 么 情况 下 Maven 运 
行 环境 中 会 有 名 为 performRelease、 值 为 true 的 属性 昵 ? 可 以 在 命令 行 指 
定 。 例 如 : 





S$ mvn clean install -DperformRelease =true 


但 是 ， 读 者 可 能 已 经 猪 到 了 ， 在 执行 release: perform 的 时 候 ， 
Maven Release Plugin 会 自动 生成 值 为 true 的 performRelease 属 性 。 这 时 ， 
超级 POM 中 的 release-profile 就 会 被 激活 。 


这 个 Profile 配 置 了 3 个 Maven 插 件 ，maven-sources-plugin 的 jar 目 标 会 
为 项 目 生 成 -source.jar 文 件 ，maven-javadoc-plugin 的 jar 目 标 会 为 项 目 生 
成 -javadoc.jar 文 件 ， 而 maven-deploy-plugin 的 update-release-info 配 置 则 会 
在 部 蜀 的 时 候 更 新 仓库 中 的 元 数据 ， 告 诉 仓库 该 版 本 是 最 新 的 发 布 版 。 
每 个 插件 配置 中 值 为 true 的 inherited 元 素 则 表示 该 插件 配置 可 以 被 子 
POM 继 承 。 











在 日 常 的 快照 开发 过 程 中 ， 往 往 没 有 必要 每 次 都 生成 -source.jar 和 - 
javadoc.jar， 但 是 当 项 目 发 布 的 时 候 ， 这 些 文件 就 显得 十 分 重要 。 超 级 








POM 中 的 release-profile 就 是 为 了 这 种 情形 而 设计 的 。 需 要 注意 的 是 ， 这 
种 隐 式 的 配置 对 于 不 熟悉 Maven 的 用 户 来 说 可 能 会 显得 十 分 令 人 费解 ， 
因此 将 来 的 Maven 版 本 中 可 能 会 从 超级 POM 中 移 除 这 段 配置 ， 所 以 如 采 
用 户 希 望 在 发 布 版 本 时 自动 生成 -sources.jar 和 -javadoc.jar， 最 好 还 是 在 
自己 的 POM 中 显 式 地 配置 这 些 插件 。 








13.5 Aah el gta sz 


13.4 节 介绍 了 如 何 使 用 Maven Release Plugin 自 动 化 版 本 发 布 ， 如 果 
回顾 一 下 图 13-2， 就 会 发 现 分 文 创建 的 操作 还 没有 具体 涉及 。 本 节 就 继 
续 基 于 实际 的 样 例 讲 解 如 何 上 自动 化 创建 分 文 。 


在 图 13-2 中 可 以 看 到 ， 在 正式 发 布 版 本 1.1.0 的 同时 ， 还 可 以 创建 一 
个 分 支 用 来 修复 将 来 这 个 版 本 可 能 遇 到 的 重大 Bug。 这 个 过 程 可 以 手工 
完成 ， 例 如 使 用 svn copy 操 作 将 主干 代码 复制 到 一 个 名 为 1.1.x 的 分 支 
中 ， 然 后 修改 分 文中 的 POM 文 件 ， 升 级 其 版 本 为 1.1.1-SNAPSHOT， 这 
会 涉及 很 多 Subversion 操 作 。 





使 用 Maven Release Plugin 的 branch 目 标 ， 它 能 够 帮 我 们 目 动 化 这 些 
操作 : 


检查 本 地 有 无 未 提交 的 代码 。 


:为 分 支 更 改 POM 的 版 本 ， 例 如 从 1.1.0-SNAPSHOT 改 变 成 1.1.1- 
SNAPSHOT。 


.将 POM 中 的 SCM 信 息 更 新 为 分 文 地 址 。 


Te LAEE N 


-将 主干 的 代码 复制 到 分 支 中 。 


-修改 本 地 代码 使 其 回 退 到 分 之 前 的 版 本 用户 可 以 指定 新 的 版 
本 


提交 本 地 更 改 。 


当然 ， 为 了 让 Maven Release Plugin 为 我 们 工作 ， 和 版 本 发 布 一 样 ， 
必须 在 POM 中 提供 正确 的 SCM 人 信息。 此 外 ， 由 于 分 支 操 作 会 涉及 版 本 
控制 系统 里 的 分 支 地 址 ， 因 此 还 要 为 Maven Release Plugin 配 置 分 支 基础 
目录 ， 如 代码 清单 13-4 所 示 。 


代码 清单 13-4 ”配置 maven-release-plugin 提 供 分 支 基 础 目录 


然而 tagBase 和 branchBase 并 非 是 一 定 要 配置 的 。 如 果 为 版 本 控制 仓 
库 使 用 了 标准 的 Subversion 布 局 ， 即 在 平行 的 trunk/tags/branches 目 录 下 
分 别 放 置 项 目 主干 代码 、 标 签 代码 和 分 文 代码 ， 那 么 Maven Release 
Plugin 就 能 够 自动 根据 主干 代码 位 置 计算 出 标签 及 分 文 代码 位 置 ， 因 此 
你 就 可 以 省 略 这 两 项 配置 。 








理解 了 创建 分 文 所 将 执行 的 实际 行为 后 ， 就 可 以 在 项 目 目录 下 运行 
如 下 命令 以 创建 分 文 : 


Smvn release:branch -DbranchName =1.1.x \ 
-DupdateBranchVersions =true -DupdateWorkingCopyVersions = false 


上 述 命令 中 使 用 了 Maven Release Plugin 的 branch 目 标 ，- 
DbranchName=1.1.x 用 来 配置 所 要 创建 的 分 支 的 名 称 ，- 
DupdateBranchVersions=true 表 示 为 分 文 使 用 新 的 版 本 ，- 
DupdateWorkingCopyVersions=false 表 示 不 更 新 本 地 代码 〈 即 主干 ) 的 版 
本 。 运 行 上 述 命令 之 后 ，Maven 会 提示 输入 分 文 项 目的 版 本 。 例 如 : 


What is the branch version for "app"? (com. juvenxu.mvnbook:app) 1.1.1-SNAPSHOT: : 








用 户 根据 自己 的 需要 为 分 文 输入 新 的 版 本 后 按 Enter 键 ，Maven 就 会 
处 理 其 余 的 操作 。 最 后 ， 用 户 就 能 在 源码 库 中 找到 Maven 创 建 的 分 支 ， 
如 https://192.168.1.103/app/branches/1.1.x/。 在 这 里 ，POM 中 的 版 本 已 经 
升级 到 了 1.1.1-SNAPSHOT。 


13.6” ”GPG 签名 





当 从 中 央 仓 库 下 载 第 三 方 构件 的 时 候 ， 你 可 能 会 想 要 验证 这 些 文件 
的 合法 性 ， 例 如 它们 是 由 开源 项 目 官 方 发 布 的 ， 并 且 没 有 被 算 改 过 。 同 
样 地 ， 当 发 布 自 己 项 目 给 客户 使 用 的 时 候 ， 你 的 客户 也 会 想 要 验证 这 些 
文件 是 否 是 由 你 的 项 目 组 发 布 的 ， 且 没有 被 恶意 算 改 过 。PGP (Pretty 
Good Privacy) 就 是 这 样 一 个 用 来 帮助 提高 安全 性 的 技术 。PGP 最 常用 
来 给 电子 邮件 进行 加 密 、 解 密 以 及 提供 签名 ， 以 提高 电子 邮件 交流 的 安 
全 性 。 本 节 介 绍 如 何 使 用 PGP 技 术 为 发 布 的 Maven 构 件 签名 ， 为 项 目 增 
强 安全 性 。 








13.6.1 GPG 及 其 基本 使 用 


GnuPG 〈 简 称 GPG， 来 目 http:/www.gnupg.org/) 是 PGP 标 准 的 一 个 
免费 实现 ， 无 论 是 类 UNIX 平 台 还 是 windows 平 台 ， 都 可 以 使 用 它 。 
GPG 能 够 帮助 我 们 为 文件 生成 签名 、 管 理 密 钥 以 及 验证 签名 等 。 








首先 ， 访问 http:/www.gnupg.org/download/ 并 下 载 对 应 自己 平台 的 


GPG 分 发 包 ， 按 照 官方 的 文档 将 GPG 安 装 完毕 ， 运 行 如 下 命令 检查 安 





装 ， 
juven@ juven-ubuntu: ~ $gpg --version 
gpg (GnuPG) 1.4.9Copyright (C) 2008 Free Software Foundation, Inc. 
License GPLv3 +: GNU GPL version 3 or later 


在 使 用 GPG 之 前 ， 先 得 为 自己 准备 一 个 密 钥 对 ， 即 一 个 私 钥 和 一 个 
公 钥 。 之 后 才 可 以 使 用 私 钥 对 文件 进行 签名 ， 并 且 将 公 钥 分 友 到 公 钥 服 
务 嚣 供 其 他 用 户 下 载 ， 用 户 可 以 使 用 公 钥 对 签名 进行 验证 。 





使 用 如 下 命令 生成 密 钥 对 : 
juven@ juven-ubuntu: ~ $gpg --gen-key 


GPG 会 问 你 密 钥 的 类 型 、 大 小 和 有 效 时 间 ， 通 常 使 用 默认 的 值 即 
可 。GPG 还 会 要 求 你 输入 自己 的 名 称 、 电 子 邮 件 地 址 和 对 密 钥 的 注释 ， 


这 些 内 容 会 被 包含 在 公 钥 中 并 说 你 的 用 户 看 到 ， 因 此 务必 正确 填写 。 最 
后 ， 还 可 以 提供 一 个 密码 来 保护 密 铀 ， 这 不 是 强制 性 的 ， 但 通 疝 最 好 提 
供 以 防止 别人 得 到 你 的 密 钥 后 恶意 使 用 。 你 将 来 需要 使 用 私 铀 和 和 冤 码 为 
文件 提供 签名 ， 因 此 一 定 要 认证 保护 它们 。 








现在 已 经 有 了 和 密 钥 对 ， 就 可 以 在 命令 行 中 但 看 它们 (其 他 叶 入 到 本 
地 机 器 的 密 钥 也 会 被 显示 )〉， 如 下 面 的 命令 可 用 来 列 出 所 有 公 钥 : 


/home/juven/.gnupg/pubring,gpg 

pub 1024D/C6EED57A 2010-01 -13 

uid Juven Xu (Juven Xu works at Sonatype) juven@ sonatype. com 
sub 2048g/D704745C 2010 -01 -13 


这 里 的 home/juven/.gnupg/pubring.gpg 表 示 公 钥 存 储 的 位 置 。 以 pub 
开头 的 一 行 显示 公 钥 的 长 度 (1024D) 、ID (C6EEDS7A) 以 及 创建 日 
期 〈2010-01-13) 。 下 一 行 显示 了 公 钥 的 UID， 也 就 是 一 个 由 名 称 、 注 
释 和 邮件 地 址 组 成 的 字符 串 。 最 后 一 行 显示 的 子 钥 不 用 关心 。 











类 似 地 ， 下 面 的 命令 用 来 列 出 本 机 私 角 : 


juven@ juven-ubuntu: ~ $gpg -list -secret-keys 


/home/juven/.gnupg/secring. gpg 
sec 1024D/C6EED57A 2010-01-13 
uid Juven Xu (Juven Xu works at Sonatype) 


~ z> 


1 
ssb 2048g/D704745C 2010 -01 -13 


对 GPG 的 公私 铀 有 了 基本 的 了 解 之 后 ， 就 可 以 使 用 如 下 命令 为 任意 


文件 创建 一 个 ASCII 格 式 的 签名 : 


juven@ juvenubuntu: ~ $gpg -ab temp. java 


这 里 的 -a 选项 告诉 GPG 创 建 ASCII 格 式 的 输出 ， 而 -b 选 项 则 告诉 
GPG 创 建 一 个 独立 的 签名 文件 。 如 果 你 的 私 钥 拥 有 密码 ， 这 个 时 候 束 十 
要 输入 密码 。 如 果 私 钥 没有 密码 ， 那 么 只 要 他 人 获得 了 你 的 私 铀 ， 就 能 
够 以 你 的 名 义 对 任何 内 容 进 行 釜 名， 这 和 是 非常 危险 的 。 





在 该 例 中 ，GPG 会 创建 一 个 名 为 temp.java.asc 的 签名 文件 ， 这 时 就 
可 以 将 这 个 后 绥 名 为 .asc 的 签名 文件 连同 原始 文件 一 起 分 发 给 你 的 用 
户 。 如 果 你 的 用 户 已 经 导入 了 你 的 公 钥 ， 就 可 以 运行 如 下 命令 验证 原始 
文件 : 





$gpg 一 -verify temp. java.asc 


为 了 能 让 你 的 用 户 获取 公 钥 并 验证 你 分 发 的 文件 ， 需 要 将 公 钥 分 发 
到 公 钥 服务 器 中 。 例 如 ，hkp: /pgp.mit.edu 是 美国 嘛 省 理工 学 院 提 供 的 
公 钥 服务 器 ， 运 行 如 下 命令 可 将 公 钥 分 发 到 该 服务 器 中 : 


$ gpg --keyserver hkp: //pgp.mit.edu --send-keys C6EED57A 


这 里 的 --Keyserver 选 项 用 来 指定 分 发 服务 器 的 地 址 ，--send-keys 用 
来 指定 想 要 分 发 公 钥 的 ID 。 你 可 以 罗列 本 地 公 钼 来 查看 它们 的 ID 。 需 要 
注意 的 是 ， 公 钥 会 在 各 个 公 钥 服务 器 中 被 同步 ， 因 此 你 不 需要 重复 地 往 


各 个 服务 器 分 发 同一 公 钥 。 
现在 ， 你 的 用 户 可 以 将 服务 器 上 的 公 钥 导入 到 本 地 机 器 : 
$ gpg --keyserver hkp: //pgp.mit.edu --recv-keys C6EED57A 


上 述 就 是 一 个 基本 的 签名 、 分 发 并 验证 的 流程 ， 在 使 用 Maven 发 布 
项 目的 时 候 ， 可 以 使 用 GPG 为 发 布 文件 提供 签名 。 现 在 读者 应 该 已 经 知 
道 如 何 手 工 完 成 这 一 步骤 了 了 ， 下 面 介 绍 如何 使 用 Maven GPG Plugin 上 自动 


化 签名 这 一 步骤 。 








13.6.2 Maven GPG Plugin 


手动 地 对 Maven 构 件 进 行 签名 并 将 这 些 签 名 部 署 到 Maven 仓 库 中 是 
一 件 耗 时 的 体力 活 。 而 使 用 Maven GPG Plugin 只 需要 提供 几 行 简单 的 配 
置 ， 它 就 能 够 帮 我 们 自动 完成 签名 这 一 工作 。 








在 使 用 Maven GPG Plugin 之 前 ， 首 先 需要 确认 命令 行 下 的 gpg 是 可 
用 的 ， 然 后 如 代码 清单 13-5 所 示 配 置 POM。 


N 


代码 清单 13-5 ”配置 maven-gpg-plugin 为 项 目 提 供 签 


<project > 


<build > 
<plugins > 
<plugin > 
<groupid >org. apache. maven. plugins < /groupId > 
<artifactId >maven-qpg-plugin < /artifactId> 
<version >1.0 </version> 
<executions > 
< execution > 
<id>sign-artifacts </id> 
<phase >verify < /phase > 
<goals > 
<goal >sign < /goal > 
</goals> 
< /execution > 
< fexecutions > 
< /plugin > 
</plugins > 


< /build> 


< /project > 


然后 就 可 以 使 用 一 般 的 mvn 命 令 签名 并 发 布 项 目 构件 : 


$mvn clean deploy -Dgpg. passphrase = yourpassphrase 


如 果 不 提供 -Dgpg.passphrase 参 数 ， 运 行 时 束 会 要 求 输入 密码 。 


如 果 有 一 些 已 经 发 布 了 但 没有 被 签名 的 文件 ， 你 仍然 想 对 其 签名 并 
发 布 到 Maven 仓 库 中 ， 上 述 方式 显然 是 行 不 通 的 ， 因 为 POM 已 经 不 允许 
被 修改 。 好 在 Maven GPG Plugin 为 此 提供 了 另外 一 个 目标 。 例 如 : 





Smvn gpg:sign-and-deploy-file 

—DpomFile =target /myapp —1.0.pom 

—Dfile =target /myapp -1.0.jar 

—Durl =http: //oss. sonatype. org /service /local /staging /deploy /maven2 / 
—DrepositoryId = sonatype_oss 


vy Yy Y 


在 这 里 可 以 指定 要 签名 的 POM 及 相关 文件 、Maven 仓 库 的 地 址 和 


ID, Maven GPG Plugin 就 会 帮 你 签名 文件 并 部 普 到 仓库 中 。 


-> 





读者 可 以 想到 ，GPG 签 名 这 一 步骤 只 有 在 项 目 发 布 时 才 显 得 必要 
对 日 常 的 NAPSHOT 构 件 进行 签名 不 仅 没 有 多 大 的 意义 ， 反 而 会 比较 耗 
时 。 因 此 ， 只 需要 配置 Maven PGP Plugin 在 项 目 发 布 的 时 候 运 行 ， 那 么 
如 何 判 断 项 目 发 布 呢 ? 回顾 代码 清单 13-3， 在 超级 POM 中 有 一 个 release- 
profile， 该 Profile 只 有 在 Maven 属 性 performRelease 为 true 的 时 候 才 被 激 
活 ， 而 release: perform 执 行 的 时 候 ， 就 会 将 该 属性 置 为 tue， 这 正 是 项 
目 进 行 版 本 发 布 的 时 刻 。 因 此 ， 类 似 地 ， 可 以 在 settings.xml 或 者 POM 中 
创建 如 代码 清单 13-6 所 示 Profile。 





代码 清单 13-6 ”配置 自动 激活 的 Profile 对 项 目 进行 签名 


<profiles > 
<profile> 
<id>release-sign-artifacts</id> 
<activation > 
<property > 
<name >performRelease < /name > 
<value >true < /Value > 
</property > 
< /activation > 
<build> 
<plugins > 
<plugin> 
<grouplId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-gpg-plugin < /artifactId > 
<version >1.0 < /version > 
<executions > 
<execution > 
<id>sign-artifacts </id> 
<phase >verify < /phase > 
<goals > 
<goal >sign < /goal > 
< /goals > 
< /execution > 
< /executions > 
< /pl ug in > 
</plugins > 
< /build> 
< /profile > 


< /profiles > 


最 后 需要 一 提 的 是 ， 由 于 一 个 已 知 的 Maven Release Plugin 的 Bug， 
release: perform 执 行 过 程 中 签名 可 能 会 导致 进程 永久 挂 起 。 为 了 避免 该 
情况 ， 用 户 需要 为 Maven Release Plugin 提 供 mavenExecutorId 配 置 ， 如 代 
码 清单 13-7 所 示 。 


代码 清单 13-7 配置 maven-release-plugin 避 免 签 名 时 永久 挂 起 


<plugin> 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-release-plugin < /artifactId> 
<version >2.0 </version> 
< configuration > 
<tagBase >https://192.168.1.103 /app/tags/ < /tagBase > 
<branchBase >https://192.168.1.103 /app/branches / < /branchBase > 
<mavenExecutorid > forked-path < /mavenExecutorId > 
< f/configuration > 
</plugin > 


至 此 ， 一 个 较为 规范 的 目 动 化 签名 配置 就 完成 了 。 当 执行 release: 
perform 发 布 项 目 版 本 的 时 候 ，maven-gpg-plugin 会 被 自动 调用 对 构件 进 
行 签 名 。 当 然 ， 这 个 时 候 你 需要 根据 命令 行 提示 输入 私 钥 密码 。 


13.7. aH 


项 目 开发 到 一 定 阶段 后 ， 就 必然 要 面 对 版 本 发 布 的 问题 ， 本 章 介 绍 
了 Maven 的 版 本 管理 方式 ， 包 括 快照 版 和 发 布 版 之 间 的 转换 、 各 种 版 本 
号 的 意义 以 及 项 目 版 本 与 版 本 控制 系统 (如 Subversion) 之 间 的 关系 。 
理解 了 版 本 转换 与 SCM 操 作 的 关系 后 ， 就 可 以 使 用 Maven Release Plugin 
自动 化 版 本 发 布 和 创建 分 支 等 操作 。 本 章 最 后 介绍 了 如 何在 版 本 发 布 的 
时 候 使 用 GPG 为 构件 提供 签名 ， 以 提供 更 强 的 安全 性 。 


第 14 革 灵活 的 构建 


‘Maven Profile 

"Web 资源 过 滤 

:在 profile 中 激活 集成 测试 
小 结 


一 个 优秀 的 构建 系统 必须 足够 灵活 ， 它 应 该 能 够 让 项 目 在 不 同 的 环 
境 下 都 能 成 功 地 构建 。 例 如 ， 典 型 的 项 目 都 会 有 开发 环境 、 测 试 环境 和 
产品 环境 ， 这 些 环境 的 数据 库 配置 不 尽 相 同 ， 那 么 项 目 构建 的 时 候 就 需 
要 能 够 识别 所 在 的 环境 并 使 用 正确 的 配置 。 还 有 一 种 常见 的 情况 是 ， 项 
目 开 发 了 大 量 的 集成 测试 ， 这 些 测试 运行 起 来 非常 耗 时 ， 不 适合 在 每 次 
构建 项 目的 时 候 都 运行 ， 因 此 需要 一 种 手段 能 让 我 们 在 特定 的 时 候 才 油 
活 这 些 集成 测试 。Maven 为 了 文 持 构 建 的 灵活 性 ， 内 置 了 三 大 特性 ， 即 











属性 、Profile 和 资源 过 滤 。 本 章 介 绍 如何 合 理 使 用 这 些 特 性 来 帮助 项 目 
目 如 地 应 对 各 种 环境 。 


14.1 Maven 属 性 





前 面 的 章节 已 经 简单 介绍 过 Maven 属 性 的 使 用 ， 例 如 在 5.9.2 节 有 如 
代码 清单 14-1 所 示 的 代码 。 


代码 清单 14-1 使 用 Maven 属 性 归 类 依赖 


<properties> 
<springframework. version >2.5.6 < /springframework. version > 
< /properties > 
< dependencies > 
< dependency > 


<groupiId >org. springframework < /qroupId > 





<artifactId>spring-core < /artifactId> 


<version > $ {sprinagframework. version} < /version > 
< /dependency > 
< dependency > 
<groupid >org. springframework < /groupid > 
<artifactId >spring-beans < /artifactId> 
<version > $ {springframework. version} < /version > 


< /dependency > 


< /dependencies > 





这 可 能 是 最 常见 的 使 用 Maven 属 性 的 方式 ， 通 过 <properties> 元 素 用 
户 可 以 自 定 义 一 个 或 多 个 Maven 属 性 ， 然 后 在 POM 的 其 他 地 方 使 用 $ 
{属性 名 称 } 的 方式 引用 该 属性 ， 这 种 做 法 的 最 大 意义 在 于 消除 重复 。 例 
如 ， 代 码 清 时 14-1 中 本 来 需要 在 多 个 地 方 重复 声明 同样 的 
SpringFramework 版 本 ， 现 在 只 在 一 个 地 方 声明 就 可 以 ， 重 复 越 多 ， 好 
处 束 越 明显 。 因 为 这 样 不 仪 减少 了 日 后 升级 版 本 的 工作 量 ， 也 能 降低 错 
误 发 生 的 概率 。 





这 不 是 Maven 属 性 的 全 部 ， 事 实 上 这 只 是 6 类 Maven 属 性 中 的 一 类 而 
己 。 这 6 类 属性 分 别 为 : 





:内 置 属性 主要 有 两 个 常用 内 置 属性 一 一 $ {basedir} 表 示 项 目 根 日 
录 ， 即 包含 pom.xml 文 件 的 目录 ; $ {version} 表 示 项 目 版 本 。 


POM) VE: 用户 可 以 使 用 该 类 属性 引用 POM 文 件 中 对 应 元 素 的 
值 。 例 如 $ {project.artifactId} 束 对 应 了 <project><artifactId> 元 素 的 值 ， 
和 常用 的 POM 属 性 包括 : 


m $ {project.build.sourceDirectory}: 项 目的 主 源码 目录 ， 默 认为 


src/main/java/。 


m $ {project.build.testSourceDirectory}: 项 目的 测试 源码 目录 ， 默 认 


为 src/test/java/。 
m $ {project.build.directory}: 项 目 构建 输出 目录 ， 默 认为 target/。 


m $ {project.outputDirectory}: 项 目 主 代码 编译 输出 目录 ， 默 认为 


target/classes/。 


m $ {project.testOutputDirectory}: 项 目测 试 代 码 编译 输出 目录 ， 默 


认为 target/test-classes/。 


m $ {project.groupId}: 项 目的 groupId。 


m $ {project.artifactId}: 项 目的 artifactId。 
m $ {project.version}: 项 目的 version， 与 $ {version} 等 价 。 


m $ {project.build.finalName}: 项 目 打 包 输 出 文件 的 名 称 ， 默 认为 $ 


{project.artifactId}- $ {project.version } o 


这 些 属性 都 对 应 了 一 个 POM 元 素 ， 它 们 中 一 些 属性 的 默认 值 都 是 在 
超级 POM 中 定义 的 ， 可 以 参考 8.5 节 。 


: 自 定义 属性 : 用 户 可 以 在 POM 的 <properties> 元 素 下 自 定义 Maven 
属性 。 例 如 : 


然后 在 POM 中 其 他 地 方 使 用 $ {my.prop} 的 时 候 会 被 蔡 换 成 hello。 


Settings 属 性 : 与 POM 属 性 同 理 ， 用 户 使 用 以 settings. 开 头 的 属性 引 
用 settings.xml 文 件 中 XML 元 素 的 值 ， 如 常用 的 
{settings.localRepository} 指 同 用 户 本 地 仓库 的 地 址 。 


Java 系统 属性 : 所 有 Java 系 统 属性 都 可 以 使 用 Maven 属 性 引用 ， 例 
如 $ {user.home} 指 同 了 用 户 目 录 。 用 户 可 以 使 用 mvn help: system 查 看 


所 有 的 Java 系 统 属性 。 





:环境 变量 属性 : 所 有 环境 变量 都 可 以 使 用 以 env. 开 头 的 Maven 必 性 
引用 。 例 如 $ {fenvJAVA_HOME} 指 代 了 JAVA_HOME 环 境 变 量 的 值 。 
用 户 可 以 使 用 mvn help: system 查 看 所 有 的 环境 变量 。 


正确 使 用 这 些 Maven 属 性 可 以 帮助 我 们 简化 POM 的 配置 和 维护 工 
作 ， 下 面 列 举 几 个 常见 的 Maven 属 性 使 用 样 例 。 





在 一 个 多 模块 项 目 中 ， 模 块 之 间 的 依赖 比较 和 常见， 这些 模块 通常 会 
使 用 同样 的 groupId 和 version。 因 此 这 个 时 候 束 可 以 使 用 POM 属 性 ， 如 
代码 清单 14-2 所 示 。 


代码 清单 14-2 ”使 用 POM 属 性 配置 依赖 


Ci 
<groupI p ect. grc Id g ipid 
<artifactid ccount—-email t act 
<versior S & ject.ve on ersi 
iepend 

depende 

<grouplId> 5 {project.groupl J ipid 
<artif tid > sount -per tifac 
< versi $ {project.versior ersior 
iepend 

jependencie 


在 代码 清单 14-2 中 ， 当 前 的 模块 依赖 于 account-email 和 account- 
persist， 这 三 个 模块 使 用 同样 的 groupId 和 version， 因 此 可 以 在 依赖 配置 
中 使 用 POM 属 性 $ {project.groupId} 和 $ {project.version}， 表 示 这 两 个 


依赖 的 groupId 和 version 与 当前 模块 一 致 。 这 样 ， 当 项 目 版 本 升级 的 时 
候 ， 就 不 再 需要 更 改 依 赖 的 版 本 了 。 


大 量 的 Maven 插 件 用 到 了 Maven 必 性， 这 意味 着 在 配置 插件 的 时 候 
同样 可 以 使 用 Maven 属 性 来 方便 地 自 定 义 插 件 行 为 。 例 如 从 10.6 节 我 们 
知道 ，maven-surefire-plugin 运 行 后 默认 的 测试 报告 目录 为 target/surefire- 








reports， 这 实际 上 就 是 $ {project.build.directory}/surefire-reports, WR Æ 
阅 该 插件 的 文档 ， 会 发 现 该 插件 提供 了 reportsDirectory 参 数 来 配置 测试 
报告 目录 。 因 此 如 果 想 要 改变 测试 报告 目录 ， 例 如 改 成 target/test- 
reports, tA) LARS 14-330 FEME E. - 


代码 清单 14-3 ”使 用 Maven 属 性 配置 插件 





从 上 面 的 内 容 中 可 以 看 到 ，Maven 属 性 能 让 我 们 在 POM 中 方便 地 引 
用 项 目 环境 和 构建 环境 的 各 种 十 分 有 用 的 值 ， 这 是 创建 灵活 构建 的 基 
础 。 下 面 将 会 结合 profile 和 资源 过 滤 ， 展 示 Maven 能 够 为 构建 提供 的 更 
多 的 可 能 性 。 


14.2 ”构建 环境 的 差异 


在 不 同 的 环境 中 ， 项 目的 源码 应 该 使 用 不 同 的 方式 进行 构建 ， 最 常 
见 的 束 是 数据 库 配 置 了 。 例 如 在 开发 的 过 程 中 ， 有 些 项 目 会 在 
Src/main/resources/ 目 录 下 放置 带 有 如 下 内 容 的 数据 库 配置 文件 : 





database.jdbc.driverClass =com. mysql. jdbc. Driver 
database. jdbc. connectionURL = jdbc :mysql://localhost :3306 /test 
database. jdbc. username = dev 

database. jdbc. password = dev-pwd 


XARITA pe cel, MAA R RE BR S E H P m PEREAT a 
候 ， 他 们 往往 需要 使 用 不 同 的 数据 库 。 这 时 的 数据 库 配 置 文件 可 能 是 这 
样 的 : 


A a 2 =com. mysql. jdbc. Driver 
database. jdbc. connect ionURL = Jabe smysql://192.168.1.100 :3306/test 


database. jdbc. username = test 
ne Gabe panaia d — nest Saie 


连接 数据 库 的 URL、 用 户 名 和 密码 都 发 生 了 变化 ， 类 似 地 ， 当 项 目 
被 发 布 到 产品 环境 的 时 候 ， 所 使 用 的 数据 库 配 置 义 是 为 外 一 套 了 。 这 个 
时 候 ， 比 较 原 始 的 做 法 是 ， 使 用 与 开 友 环境 一 样 的 构建 ， 然 后 在 测试 或 
者 发 布 产品 之 前 再 手动 更 改 这 些 配置 。 这 是 可 行 的， 也 是 比较 各 见 的 ， 
但 肯定 不 是 最 好 的 方法 。 本 书 已 经 不 止 一 次 强调 ， 手 动 往往 就 意味 着 低 
效 和 错误 ， 因 此 需要 找到 一 种 方法 ， 使 它 能 够 目 动 地 应 对 构建 环境 的 差 























=A 
FF o 


Maven 的 答案 是 针对 不 同 的 环境 生成 不 同 的 构件 。 也 就 是 说 ， 在 构 
建 项 目的 过 程 中 ，Maven 就 已 经 将 这 种 差异 处 理 好 了 。 


为 了 应 对 环境 的 变化 ， 首 先 需 要 使 用 Maven 属 性 将 这 些 将 会 发 生变 
化 的 部 分 提取 出 来 。 在 上 一 节 的 数据 库 配 置 中 ， 连 接 数 据 库 使 用 的 驱动 
类 、URL、 用 户 名 和 密码 都 可 能 发 生变 化 ， 因 此 用 Maven 属 性 取代 它 
们 : 


database.Jdbc.driverClass = $ {db. driver} 

database. jdbc. connectionURL = 5 tab: url} 

database. p username = $ {db. username} 

database. jdbc. password = $ (db. password} 

这 里 定义 了 4 个 Maven 属 性 : db.driver、db.url、db.username 和 
db.password， 它 们 的 命名 是 任意 的 ， 读 者 可 以 根据 自己 的 实际 情况 定义 


合适 的 属性 名 称 。 





既然 使 用 了 Maven 属 性 ， 就 应 该 在 某 个 地 方 定义 它们 。14.1 节 介绍 
过 如 何 自 定义 Maven 属 性 ， 这 里 要 做 的 是 使 用 一 个 额外 的 profile 将 其 包 
里 ， 如 代码 清单 14-4 所 示 。 


代码 清单 14-4 针对 开发 环境 的 数据 库 配置 


<profiles > 
<profile> 
<id>dev</id> 
<properties > 
<db. driver >com.m ysql. jdbc. Driver < /db. driver > 
“db.url > jdbc :mysql : //192 .168.1.100:3306/test < /db. url > 
< -ab. username > dev < /db. username > 


代码 清单 14-4 中 的 Maven 属 性 定义 与 直接 在 POM 的 properties 元 素 下 
定义 并 无 二 致 ， 这 里 只 是 使 用 了 一 个 id 为 dev 的 profile， 其 目的 是 将 开发 
环境 下 的 配置 与 其 他 环境 区 别 开 来 。 关 于 profile， 本 章 将 详细 解释 。 


有 了 属性 定义 ， 配 置 文件 中 也 使 用 了 这 些 属 性 ， 一 切 OK 了 吗 ? 还 
不 行 。 读 者 要 留意 的 是 ，Maven 属 性 默认 只 有 在 POM 中 才 会 被 解析 。 也 
就 是 说 ，$ {db.username} 放 到 POM 中 会 变 成 test， 但 是 如 果 放 到 
src/main/resources/ 目 录 下 的 文件 中 ， 构 建 的 时 候 它 将 仍然 还 是 $ 
{db.username}。 因 此 ， 需 要 让 Maven 解 析 资 源 文件 中 的 Maven 属 性 。 


资源 文件 的 处 理 其 实 是 maven-resources-plugin 做 的 事情 ， 它 默认 的 
行为 只 是 将 项 目 主 资源 文件 复制 到 主 代 码 编译 输出 目录 中 ， 将 测试 资源 
文件 复制 到 测试 代码 编译 输出 目录 中 。 不 过 只 要 通过 一 些 简单 的 POM 配 
置 ， 该 插件 就 能 够 解析 资源 文件 中 的 Maven 属 性 ， 即 开局 资源 过 涯 。 








Maven 默 认 的 主 资源 目录 和 测试 资源 目录 的 定义 是 在 超级 POM 中 
《可 以 回顾 8.5 节 ) 。 要 为 资源 目录 开启 过 滤 ， 只 要 在 此 基础 上 添加 一 
行 filtering 配 置 即 可 ， 如 代码 清单 14-5 所 示 。 


代码 清单 14-5 ”为 主 资源 目录 开局 过 滤 


-y > $ {project. basedir}/src/main/resources < /directory > 


>true < /filtering > 





类 似 地 ， 代 码 清单 14-6 中 的 配置 为 测试 资源 目录 开局 了 过 滤 。 


代码 清单 14-6 ”为 测试 资源 目录 开局 过 渡 


<testResources > 
<testResource > 
<directory > $ {project. basedir}/src/ test /resources < /directory > 
<filtering >true < /filtering > 
< /testResource > 


< /testResources > 


读者 可 能 还 会 从 上 述 代 码 中 意识 到 ， 主 资源 目录 和 测试 资源 目录 都 
可 以 超过 一 个 ， 虽 然 会 破坏 Maven 的 约定 ， 但 Maven 人 允许 用 户 声 明 多 个 
资源 目录 ， 并 且 为 每 个 资源 目录 提供 不 同 的 过 滤 配 置 ， 如 代码 清单 14-7 
所 示 。 





代码 清单 14-7 配置 多 个 资源 目录 


<resources > 
< resource > 
<directory >src/main/resources < /directory > 


< filtering >true < /filtering > 


ory >src/main/sql < /directory > 


1g >false</filtering > 





< resources > 








代码 清单 14-7 配 置 了 两 个 资源 目录 ， 其 中 src/main/resources 开 局 了 


过 滤 ， 而 srcmain/sql 没 有 启用 过 滤 。 








到 目前 为 止 一 切 基 本 就 绪 了 ， 我 们 将 数据 库 配 置 的 变化 部 分 提取 成 
了 Maven 属 性 ， 在 POM 的 profile 中 定义 了 这 些 属 性 的 值 ， 并 且 为 资源 目 
录 开 启 了 属性 过 滤 。 最 后 ， 只 需要 在 命令 行 激活 profile，Maven 就 能 够 
在 构建 项 目的 时 候 使 用 profile 中 属性 值 蔡 换 数据 库 配 置 文件 中 的 属性 引 
用 。 运 行 命令 如 下 : 





$ mvn clean install-Pdev 


mvn 的 -P 参 数 表示 在 命令 行 激活 一 个 profile。 这 里 激活 了 id 为 dev 的 
profile。 构 建 完 成 后 ， 输 出 目录 中 的 数据 库 配 置 就 是 开发 环境 的 配置 
T: 





databas KRA c.driverClass =com. my mee i iu Driver 
database. jdbc.connectionURL = jdbc:mysql://localhost: 5 
database. jdbc rname = dev 


da babasa , jdbc . passwor a = dev-pwa 


14.4 Maven Profile 





从 前 面 内 容 我 们 看 到 ， 不 同 环境 的 构建 很 可 能 是 不 同 的 ， 典 型 的 情 
况 就 是 数据 库 的 配置 。 除 此 之 外 ， 有 些 环境 可 能 需要 配置 插件 使 用 本 地 
文件 ， 或 者 使 用 特殊 版 本 的 依赖 ， 或 者 需要 一 个 特殊 的 构件 名 称 。 要 想 
使 得 一 个 构建 不 做 任何 修改 就 能 在 任何 环境 下 运行 ， 往 往 是 不 可 能 的 。 
为 了 能 让 构建 在 各 个 环境 下 方便 地 移植 ，Maven 引 入 了 profile 的 概念 。 
profile 能 够 在 构建 的 时 候 修 改 POM 的 一 个 子 集 ， 或 者 添加 额外 的 配置 元 
素 。 用 户 可 以 使 用 很 多 方式 激活 profile， 以 实现 构建 在 不 同 环境 下 的 移 
植 。 





14.4.1 针对 不 同 环境 的 profile 


继续 以 14.2 节 介绍 的 数据 库 差 异 为 例 ， 代 码 清单 14-4 引 入 了 一 个 针 
对 开发 环境 的 profile， 类 似 地 ， 可 以 加 入 测试 环境 和 产品 环境 的 
profile， 如 代码 清单 14-8 所 示 。 





代码 清单 14-8 基于 开发 环境 和 测试 环境 的 profile 


<profiles > 
<profile> 
<id>dev</id> 
<properties > 


<db. driver >com. mysql. jdbc. Driver < /db. driver > 
<db. url >jdbce:mysql://localhost :3306/test < /db.url > 





<properties > 


<db. driver >com. mysql. jdbc. Driver < /db. driver > 
<db.url > jdbc:mysql://192.168.1.100 :3306/test < /db. url > 
<db.username >test < /db. username > 
< db. password >test-pwd < /db. password > 
< /properties > 
</profile> 
< /profiles > 


同样 的 属性 在 两 个 profile 中 的 值 是 不 一 样 的 ，dev profile 提 供 了 开发 
环境 数据 库 的 配置 ， 而 test profile 提 供 的 是 测试 环境 数据 库 的 配置 。 类 
似 地 ， 还 可 以 添加 一 个 基于 产品 环境 数据 库 配 置 的 profile。 由 于 篇 幅 原 
因 ， 在 此 不 再 歼 述 。 








现在 ， 开 发 人 员 可 以 在 使 用 mvn 命 令 的 时 候 在 后 面 加 上 -Pdev 激 活 
dev profile， 而 测试 人 员 可 以 使 用 -Ptest 激 活 test profile. 


14.4.2 ”激活 profile 


为 了 尽 可 能 方便 用 户 ，Maven 支 持 很 多 种 激活 Profile 的 方式 。 
1. 命 令 行 激活 


用 户 可 以 使 用 mv 命令 行 参数 -P 加 上 profile 的 id 来 激活 profile， 多 个 
id 之 间 以 有 逗 号 分 隔 。 例 如 ， 下 面 的 命令 激活 了 dev-x 和 dev-y 两 个 profile: 





$ mvn clean install -—Pdev -x,dev-y 
2.settings 文 件 显 式 激活 


如 果 用 户 和 希望 某 个 profile 默 认 一 直 处 于 激活 状态 ， 就 可 以 配置 
settings.xml 文 件 的 activeProfiles 元 系 ， 表 示 其 配置 的 profile 对 于 所 有 项 目 
都 处 于 激活 状态 ， 如 代码 清单 14-9 所 示 。 





代码 清单 14-9 ”settings 文 件 显 式 激活 profile 


9.5 节 就 曾经 用 到 这 种 方式 默认 激活 了 一 个 关于 仓库 配置 的 profile。 


3. 系 统 属性 激活 


用 户 可 以 配置 当 某 系统 属性 存在 的 时 候 ， 自 动 激活 profile， 如 代码 
清单 14-10 所 示 。 


代码 清单 14-10 录 系 统 属性 存在 时 激活 profile 


<profiles > 
<profile> 
<activation > 
<property > 
<name >test < /name > 
< / property > 


< /activation > 


</profile> 


< /profiles > 


可 以 进一步 配置 当 某 系统 属性 test 存 在 ， 且 值 等 于 x 的 时 候 激 活 
profile， 如 代码 清单 14-11 所 示 。 


代码 清单 14-11 茶 系 统 属性 存在 且 值 确定 时 激活 profile 


<profiles > 
<profile> 
<activation > 
<property > 
<name >test < /name > 
<value >x< /value> 
< / property > 


< /activation > 


</profile> 


< /profiles > 


不 要 二 了 ， 用 户 可 以 在 命令 行 声明 系统 属性 。 例 如 


$mvn clean install -Dtest =x 


因此 ， 这 其 实 也 是 一 种 从 命令 行 激 活 profile 的 方法 ， 而 且 多 个 
profile 完 全 可 以 使 用 同一 个 系统 属性 来 激活 。 


4. 操 作 系 统 环境 激活 


Profile 还 可 以 自动 根据 操作 系统 环境 激活 ， 如 果 构 建 在 不 同 的 操作 
系统 有 差异 ， 用 户 完 全 可 以 将 这 些 差 异 写 进 profile， 然 后 配置 它们 目 动 
基于 操作 系统 环境 激活 ， 如 代码 清单 14-12 所 示 。 


代码 清单 14-12 ”基于 操作 系统 环境 激活 profile 


<name >Windows XP < /name > 
< family >Windows < / family > 
<arch >x86 < /arch > 


"Sion >5.1.2600 < /version > 


这 里 family 的 值 包括 Windows、UNIX 和 Mac 等 ， 而 其 他 几 项 name、 
arch、version， 用 户 可 以 通过 查看 环境 中 的 系统 属性 os.name、os.arch、 


os.version 获 得 。 


5. 文 件 存 在 与 否 激 活 











Maven 能 够 根据 项 目 中 茶 个 文件 存在 与 耕 来 决定 是 否 激 活 profile， 


如 代码 清单 14-13 所 示 。 


代码 清单 14-13 ”基于 文件 存在 与 否 激活 profile 


<profiles > 
<profile> 
<activation > 
<file> 
<missing >x. properties < /missing > 
<exists >y. properties < /exists > 
</file> 


< /activation > 


</profile> 


< /profiles > 
6. 默 认 激 活 


用 户 可 以 在 定义 profile 的 时 候 指 定 其 默认 激活 ， 


代码 清单 14-14 ”默认 激活 profile 


<profiles> 
<profile> 
<id>dev</id> 
<activation > 
<activeByDefault >true < /activeByDefault > 


< activation > 


如 代码 清单 14-14 所 


使 用 activeByDefault 元 素 用 户 可 以 指定 profile 上 自动 激活 。 不 过 需要 
注意 的 是 ， 如 果 POM 中 有 任何 一 个 profile 通 过 以 上 其 他 任意 一 种 方式 被 


激活 了 ， 上 所 有 的 默认 激活 配置 都 会 失效 。 


如 果 项 目 中 有 很 多 的 profile， 它 们 的 激活 方式 各 异 ， 用 户 怎 么 知道 
哪些 profile 被 激活 了 呢 ? maven-help-plugin 提 供 了 一 个 目标 帮助 用 户 了 
解 当 前 激活 的 profile: 





$mvn help:active-profiles 
maven-help-plugin 还 有 另外 一 个 目标 用 来 列 出 当前 所 有 的 profile: 


$mvn help:all-profiles 


14.4.3 ”profile 的 种 类 


根据 具体 的 需要 ， 可 以 在 以 下 位 置 声 明 profile: 
:pom.xml: 很 显然 ，pom.xml 中 声明 的 profile 只 对 当前 项 目 有 效 。 


用户 settings.xml: 用 户 目 录 下 .m2/settings.xml 中 的 profile 对 本 机 .上 
该 用 户 所 有 的 Maven 项 目 有 效 。 


全 局 settings.xml: Maven 安 装 目 录 下 conf/settings.xml 中 的 profile 对 
本 机 上 所 有 的 Maven 项 目 有 效 。 


:profiles.xml (Maven 2) : 还 可 以 在 项 目 根 目录 下 使 用 一 个 额外 的 
profiles.xml 文 件 来 声明 profile， 不 过 该 特性 已 经 在 Maven 3 中 被 移 除 。 建 


议 用 户 将 这 类 profile 移 到 settings.xml 中 。 


2.7.2 节 已 经 解释 过 ， 为 了 不 影响 其 他 用 户 且 方便 升级 Maven， 用 户 
应 该 选择 配置 用 户 范围 的 settings.xml， 避 免 修 改 全 局 范围 的 settings.xml 
文件 。 也 正 是 因为 这 个 原因 ， 一 般 不 会 在 全 局 的 settings.xml 文 件 中 添加 


profile。 


像 profiles.xml 这 样 的 文件 ， 默 认 是 不 会 被 Maven 安 装 到 本 地 仓库 ， 
或 者 部 署 到 远程 仓库 的 。 因 此 一 般 来 说 应 该 避免 使 用 ，Maven 3 也 不 再 





支持 该 特性 。 但 如 果 在 用 Maven 2， 而 且 需 要 为 几 十 或 者 上 百 个 客户 执 
行 不 同 的 构建 ， 往 POM 中 放置 这 么 多 的 profile 可 能 就 不 太 好 。 这 时 可 以 
选择 使 用 profiles.xzml， 如 代码 清单 14-15 所 示 。 


代码 清单 14-15 ”使 用 profiles.xml 





如 果 是 Maven 3， 则 应 该 把 这 些 内 容 移动 到 settings.xml 中 。 





不 同类 型 的 profile 中 可 以 声明 的 POM 元 素 也 是 不 同 的 ，pom.xml 中 
的 profile 能 够 随 着 pom.xml 一 起 被 提 交 到 代码 仓库 中 、 被 Maven 安 装 到 本 
地 仓库 中 、 补 部署 到 远程 Maven 仓 库 中 。 换 言 之 ， 可 以 保证 该 profile 伴 
随 着 某 个 特定 的 pom.xml 一 起 存在 ， 因 此 它 可 以 修改 或 者 增加 很 多 POM 
元 素 ， 见 代码 清单 14-16。 





代码 清单 14-16 POM 中 的 profile 可 使 用 的 元 素 


<project > 
<repositories > < /repositories > 
<pluginRepositories > < /pluginRepositories > 
<distributionManagement > < /distributionManagement > 
< dependencies > < /dependencies > 


< /dependencyManagement > 





2s > < /properties > 
ig > < /reporting > 








从 代码 清单 14-16 中 可 以 看 到 ， 可 供 pom 中 profile 使 用 的 元 素 非 常 
多 ， 在 pom profile 中 用 户 可 以 修改 或 添加 仓库 、 插 件 仓库 以 及 部 署 仓 库 
地 址 ;可 以 修改 或 者 添加 项 目 依 赖 ， 可 以 修改 聚合 项 目的 聚合 配置 ， 可 
以 目 由 添加 或 修改 Maven 属 性 ， 添 加 或 修改 项 目 报告 配置 ，pom profile 
还 可 以 添加 或 修改 插件 配置 、 项 目 资源 目录 和 测试 资源 目录 配置 以 及 项 
目 构 件 的 默认 名 称 。 


与 pom.xml 中 的 profile 对 应 的 ， 是 其 他 三 种 外 部 的 profile， 由 于 无 法 
保证 它们 能 够 随 着 特定 的 pom.xml 一 起 被 分 及 ， 因 此 Maven 不 允许 它们 
添加 或 者 修改 绝 大 部 分 的 pom 元 素 。 举 个 简单 的 例子 。 假 设 用 户 Jack 在 
目 己 的 settings.xml 文 件 中 配置 了 一 个 profile， 为 了 让 项 目 A 构建 成 功 ， 

Jack 在 这 个 profile 中 声明 几 个 依赖 和 几 个 插件 ， 然 后 通过 激活 该 profile 将 
项 目 构 建成 功 了 。 但 是 ， 当 其 他 人 获得 项 目 A 的 源码 后 ， 它 们 并 没有 


Jack settings.xml 中 的 profile， 因 此 它们 无 法 构建 项 目 ， 这 就 导致 了 构建 
的 移植 性 问题 。 为 了 避免 这 种 问题 的 出 现 ，Maven 不 允许 用 户 在 
settings.xml 的 profile 中 声明 依赖 或 者 插件 。 事 实 上 ， 在 pom.xml 外 部 的 
profile 只 能 够 声明 如 代码 清单 14-17 所 示 几 个 元 素 。 


代码 清单 14-17 POM 人 外 部 的 profile 可 使 用 的 元 素 


现在 不 用 担心 PZOM 处 部 的 profile 会 对 项 目 产 生 太 大 的 影响 了 ， 事 实 
上 这 样 的 profile 仅 仅 能 用 来 影响 到 项 目的 仓库 和 Maven 属 性 。 


14.5 ”Web 资源 过 滤 


14.3 节 介绍 了 如 何 开 启 资 源 过 滤 ， 在 Web 项 目 中 ， 资 源 文 件 同 样 位 
于 src/main/resources/ 目 录 下 ， 它 们 经 处 理 后 会 位 于 WAR 包 的 WEB- 
INF/classes 目 录 下 ， 这 也 是 Java 代 码 编 译 打 包 后 的 目录 。 也 就 是 说 ， 这 
类 资源 文件 在 打包 过 后 位 于 应 用 程序 的 classpath 中 。Web 项 目 中 还 有 男 
外 一 类 资源 文件 ， 默 认 它 们 的 源码 位 于 src/main/webapp/ 目 录 ， 经 打包 后 
位 于 WAR 包 的 根 目录 。 例 如 ， 一 个 Web 项 目的 css 源 码 文件 在 
src/main/webapp/css/ 目 录 ， 项 目 打包 后 可 以 在 WAR 包 的 css/ 目 录 下 找到 
对 应 的 css 文 件 。 这 一 类 资源 文件 称 做 web 资 源 文件 ， 它 们 在 打包 过 后 不 
位 于 应 用 程序 的 classpath 中 。 








与 一 般 的 资源 文件 一 样 ，web 资 源 文 件 默 认 不 会 被 过 小。 开局 一 般 
资源 文件 的 过 滤 也 不 会 影响 到 web 资 源 文件 。 


不 过 有 的 时 候 ， 我 们 可 能 希望 在 构建 项 目的 时 候 ， 为 不 同 的 客户 使 
用 不 一 样 的 资源 文件 〈 例 如 客户 的 logo 图 片 不 同 ， 或 者 css 主 题 不 同 ) 。 
这 时 可 以 在 web 资 源 文件 中 使 用 Maven 属 性 ， 例 如 用 $ {client.logo} #78 
客户 的 logo 图 片 ， 用 $ {client.theme} 表 示 客 户 的 css 主 题 。 然 后 使 用 
profile 分 别 定 义 这 些 Maven 属 性 的 值 ， 如 代码 清单 14-18 所 示 。 


代码 清单 14-18 针对 不 同 客户 web 资 源 的 profile 


<profiles > 
<profile> 
<id>client-a</id> 
<properties > 
<client.logo >a. jpg < /client. logo > 
<client. theme >red< /client.th 
< /properties > 
< /profile> 
<profile> 


eme > 


<id>client -b</id> 
<properties > 
<client. logo >b. jpg < /client.logo> 
<client, theme >blue < /client. theme > 
< /properties > 
«</profile> 
< /profiles > 





最 后 需要 配置 maven-war-plugin 对 Srcmain/webapp/ 这 一 web 资 源 目录 
开启 过 小 ， 如 代码 清单 14-19 所 示 。 


代码 清单 14-19 ”为 web 资 源 目录 src/main/webapp/ 开 局 过 } 


y AN 


<plugin > 


<groupId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-war-plugin < /artifactId 
<version >2.1 -beta -1 < /version > 
<configuration > 
<webResources > 
< resource > 


<filtering >true < /filtering > 


directory >srce/main/webapp < /directory > 
< includes > 

<include > * x /*x .css < /include > 
<include > * x /* .js < /include > 

< /includes > 
< / resource > 
< /webResources > 
< /configuration > 

< /plugin> 


代码 清单 14-19 中 声明 了 web 资 源 目录 Srcmain/webapp 〈 这 也 是 默认 
的 web 资 源 目 录 ) ， 然 后 配置 filtering 开 启 过 滤 ， 并 且 使 用 ipcludes 指 定 


要 过 小 的 文件 ， 这 里 是 所 有 css 和 js 文件 。 读 者 可 以 模仿 上 述 配 置 添加 额 
外 的 web 资 源 目录 ， 选 择 是 否 开 局 过 滤 ， 以 及 包含 或 者 排除 一 些 该 目录 
下 的 文件 。 


配置 完成 后 ， 可 以 选择 激活 某 个 profile 进 行 构建 ， 如 mvn clean 
install-Pclinet-a， 告 诉 web 资 源 文 件 使 用 logo 图 片 ajpg， 使 用 css 主 题 


red。 


14.6 ”在 profile 中 激活 集成 测试 





很 多 项 目 都 有 大 量 的 单元 测试 和 集成 测试 ， 单 元 测试 的 粒度 较 细 ， 
运行 较 快 ， 集 成 测试 粒度 较 粗 ， 运 行 比较 耗 时 。 在 构建 项 目 或 者 做 持续 
集成 的 时 候 ， 我 们 都 应 当 尽 量 运 行 所 有 的 测试 用 例 ， 但 是 当 集 成 测试 比 
较 多 的 时 候 ， 高 频率 地 运行 它们 就 会 变 得 不 现实 。 因 此 有 一 种 更 为 合理 
的 做 法 。 例 如 ， 每 次 构建 时 只 运行 所 有 的 单元 测试 ， 因 为 这 不 会 消耗 太 
多 的 时 间 〈 可 能 小 于 5 分 钟 )， 然 后 以 一 个 相对 低 一 点 的 频率 执行 所 有 
集成 测试 “例如 每 天 2 次 ) 。 











TestNG 中 组 的 概念 能 够 很 好 地 支持 单元 测试 和 集成 测试 的 分 类 标 
记 。 例 如 ， 可 以 使 用 如 下 的 标注 表示 一 个 测试 方法 属于 单元 测试 : 





@ Test (groups = {"unit"}) 
然后 使 用 类 似 的 标注 表示 东 个 测试 方法 为 集成 测试 : 
@ Test (groups = {"integration"}) 


使 用 上 述 方法 可 以 很 方便 清晰 地 声明 每 个 测试 方法 所 属 的 类 别 。 下 
面 的 工作 就 是 告诉 Maven 默 认 只 执行 所 有 的 单元 测试 ， 只 在 特定 的 时 候 
才 执 行 集成 测试 ， 见 代码 清单 14-20 所 示 。 


代码 清单 14-20 ”在 profile 中 配置 执行 TestrNG 测 试 组 


<project > 
<build> 
<plugins > 
<piug in > 
<groupId 


<artifactīId>m 





sion >2:.5<, 





< configuration > 
<groups >unit </ 
< /configuration > 
< /plugin > 
< /plugins > 
< /build> 
<profiles > 
<profile> 
<id>full</id> 
<build> 





<artifactId >ma\ 


version> 





> org. apache. maven. plugins < 


fart 


1-surefire-plugin < 


en-surefire-plugin < 


/grouplid > 


factId > 


ipId > org. apache. maven. plugins < /groupId > 


如 果 读 者 对 Maven 集 成 TestNG 不 熟悉 ， 请 先 回 顾 10.7 节 。 代 码 清单 
14-20 中 首先 配置 了 maven-surefire-plugin 执 行 unit 测 试 组 ， 也 就 是 说 默认 
Maven 只 会 执行 单元 测试 。 如 果 想 要 执行 集成 测试 ， 瓯 需要 激活 full 
profile， 在 这 个 profile 中 配置 了 maven-surefire-plugin 执 行 unit 和 integration 


两 个 测试 组 。 








有 了 上 述 配置 ， 用 户 就 可 以 根据 实际 情况 配置 持续 集成 服务 器 。 例 





如 ， 每 阳 15 分 钟 检 查 源码 更 新 ， 如 有 更 新 则 进行 一 次 默认 构建 ， 即 只 包 
含 单元 测试 。 此 外 ， 还 可 以 配置 一 个 定时 的 任务 。 例 如 ， 每 天 执行 两 


次 ， 执 行 一 个 激活 full profile 的 构建 ， 以 包含 所 有 的 集成 测试 。 


从 该 例 中 可 以 看 到 ，profile 不 仅 可 以 用 来 应 对 不 同 的 构建 环境 以 保 
持 构 建 的 可 移植 性 ， 还 可 以 用 来 分 离 构 建 的 一 些 较 耗 时 或 者 耗资 源 的 行 
为 ， 并 给 予 更 合适 的 构建 频率 。 


14.7. aH 





项 目 构建 过 程 中 一 个 常常 需要 面 对 的 问题 就 是 不 同 的 平台 环境 差 
异 ， 这 可 能 是 操作 系统 的 差异 、 开 发 平台 和 测试 平台 的 差异 、 不 同 客户 
之 间 的 差异 。 


为 了 应 对 这 些 差 蜡 ，Maven 提 供 了 属性 、 资 源 过 小 以 及 profile 三 大 
特性 。Maven 用 户 可 以 在 POM 和 资源 文件 中 使 用 Maven 属 性 表示 那些 可 
能 变化 的 量 ， 通 过 不 同 profile 中 的 属性 值 和 资源 过 滤 特 性 为 不 同 环 境 执 
行 不 同 的 构建 。 





读者 需要 区 分 Web 项 目 中 一 般 资 源 文 件 和 web 资 源 文 件 ， 前 者 是 通 
过 maven-resources-plugin 处 理 的 ， 而 后 者 通过 maven-war-plugin 处 理 。 
本 章 还 详细 介绍 了 profile， 包 括 各 种 类 别 profile 的 特点 ， 以 及 激活 


profile 的 多 种 方式 。 除 此 之 外 ， 本 章 还 贯穿 了 几 个 实际 的 示例 ， 相 信 它 
们 能 够 帮助 读者 理解 什么 才 是 灵活 的 构建 。 





第 15 章 

本 章 内 容 
最 简单 的 站 点 

.丰富 项 目 信息 

:项目 报告 插件 

. 自 定义 站 点 外 观 
.创建 自 定义 页 面 

.国际 化 

部署 站 点 


.小结 


生成 项 目 站 扣 


Maven 不 仪 仪 古 一 个 上 自动 化 构建 工具 和 一 个 依赖 写 理 工具 ， 它 还 能 


够 帮助 聚合 项 目 信 息 
息 ， 如 项 目 描述 
自 


au 


的 形式 发 布 这 些 信息 


， 促 进 团 队 间 的 交流 
、 版 本 控制 系统 地 址 、 缺 陷 跟 踪 系 统 地 址 、 
开发 者 信息 等 。 用 户 可 以 让 Maven 自 动 生 成 一 个 Web 站 点 ， 


。 此 外 ，Maven 社 区 提供 了 大 量 插 件 ， 


。POM 可 以 包含 各 种 项 目 信 
许可 证 信 
以 Web 
能 让 用 户 生 


成 各 种 各 样 的 项 目 审 碍 报告 ， 包 括 测 试 履 兰 率 、 静 态 代码 分 析 、 代 码 变 
更 等 。 本 章 详细 介绍 如 何 生成 Maven 站 点 ， 以 及 如 何 配置 各 种 插件 生成 
项 目 报告 。 读 完 本 章 ， 应 该 能 够 为 目 己 的 项 目 生 成 漂亮 的 Maven 站 点 ， 
更 便捷 、 更 快速 地 为 团队 提供 项 目 当前 的 状态 信息 。 





15.1 最 简单 的 站 点 


对 于 Maven 2 来 说 ， 站 点 生成 的 逻辑 是 Maven 核 心 的 一 部 分 。 鉴 于 
灵活 性 和 可 扩展 性 考虑 ， 在 Maven 3 中 ， 这 部 分 逻辑 已 从 核心 中 移 除 。 
由 于 此 设计 的 变动 ，Maven 3 用 户 必须 使 用 3.x 版 本 的 maven-site-plugin。 
例如 : 


<pluginManagement > 
<plugins > 
<plugin > 


<groupid >org.apache.maven.plugins < /GroupIQ > 


iQ 


<artifactId >maven-site-plugin < /artifactid> 
<version >3.0-beta-l < /version > 
< /plugin> 
< /plugins > 
< /pluginManagement > 


Maven 2 用 户 则 应 该 使 用 maven-site-plugin 最 新 的 2.x 版 本 。 例 如 : 


<pluginManagement > 
<plugins > 
<plugin > 
< groupId >org.apache.maven. plugins < /groupId > 
<artifactId >maven-site-plugin < /artifactid> 
<version >2.1.1</version> 
< /plugin > 
< /plugins > 
< /pluginManagement > 


配置 了 正确 版 本 的 maven-site-plugin 之 后 ， 在 项 目下 运行 mvn sites 
能 直接 生成 一 个 最 简单 的 站 点 ， 用 户 可 以 看 到 如 下 方 代码 所 示 的 命令 行 
输出 。 


[INFO] [site:site {exer cution: default-cli}] 

[WARNING] No URL « defined for the project-decoration links will not be resolved 
Generating "Plugin Management" report. 

ating "Mailing Lists" ey 

ating "Continuous Integration" report. 

ating "Dependency Management" report. 

‘ating "Project License" report. 








* report, 





[INFO] Generating "Project Summary" report. 
[INFO] Generating ae abe 1cy Convergence" report. 
INFO] Generating "Dependencies" report. 


待 Maven 运 行 完毕 后 ， 可 以 在 项 目的 target/site/ 目 录 下 找到 Maven 生 
成 的 站 点 文件 ， 包 括 dependencies.html、dependency-convergence.html、 
index.html 等 文件 和 css、images 文 件 夹 。 读 者 能 够 从 这 些 文件 及 文件 夹 
的 名 字 中 猜 到 其 中 的 内 容 : css 和 images 文 件 夹 是 用 来 存放 站 点 相关 的 图 
片 和 css 文 件 的 ， 其 他 html 文 件 基本 对 应 了 一 项 项 目 信 息 ， 如 
dependencies.htm] 包 含 了 项 目 依赖 信息 ，license.html 包 含 了 项 目 许可 证 
信息 。index.html 则 是 站 点 的 主页 面 ， 用 浏览 历 打 开 就 能 看 到 图 15-1 所 示 
的 页 面 。 





从 图 15-1 中 可 以 看 到 ， 左 边 导 航 栏 的 下 方 包含 了 各 类 项 目 信 息 的 链 
接 ， 包 括 持续 集成 、 依 赖 、 问 题 退 踪 、 邮 件 列表 、 团 队 、 源 码 库 等 。 





如 果 这 是 一 个 聚合 项 目 ， 导 航 栏 的 上 方 还 会 包含 子 模块 的 链接 ， 但 
古 如 末 单 击 这 些 链接 ， 将 无 法 转 到 子 模块 的 项 目 页 面 。 这 是 由 于 多 模块 
Maven 项 目 本 身 的 目录 结构 导致 的 。 如 果 将 站 点 发 布 到 服务 右上， 该 问 

















题 会 目 然 消 失 。 如 果 想 在 本 地 和 查看 结构 正确 的 站 点 ， 则 可 以 maven-site- 
plugin 的 stage 目 标 ， 将 站 点 预 发 布 至 茶 个 本 地 临时 目录 下 。 例 如 : 


$ mvn site:stage -DstagingDirectory =D: \tmp 
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Management 
Issue Tracking 





Mailing Lists 

Plugin Management 
Project License 
Project Summary 
Project Team 
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Built by: “Se. 
Maven 














图 15-1 最 简单 的 Maven 站 点 


上 述 命令 表示 生成 项 目 站 点 ， 并 预 友 布 全 D: \tmp 目 录 。 读 者 可 以 
到 该 目录 下 找到 项 目 站 点 的 html 文 件 ， 父 子 模块 之 间 的 链接 也 是 可 用 
的 。 


回顾 7.2.4 节 ， 我 们 知道 site 生 命 周期 有 四 个 阶段 ， 它 们 分 别 为 pre- 


site、site、post-site 和 site-deploy。 其 中 ，pre-site 和 post-site 默 认 没 有 绑 定 
任何 插件 目标 ， 可 以 说 它们 是 预 留 给 用 户 做 一 些 站 点 生成 之 前 及 之 后 的 
处 理 的 ; site 阶 段 绑 定 到 了 maven-site-plugin 的 Site 目标， 该 目标 负责 生成 
项 目 站 点 ， 因 此 之 前 使 用 简单 的 mvn site 命 令 就 能 直接 生成 项 目 站 点 ; 
site-deploy 目 标 绑 定 了 maven-site-plugin 的 deploy 目 标 ， 该 目标 负责 将 站 
点 部 署 至 远程 服务 器 。 本 章 稍 后 会 详细 解释 自动 化 站 点 部 普 。 


15.2 ”丰富 项 目 信 息 


在 15.1 节 中 可 以 看 到 ， 在 默认 情况 下 Maven 生 成 的 站 点 包含 了 很 多 
项 目 信息 链接 ， 这 其 实 是 由 一 个 名 为 maven-project-info-reports-plugin 的 
插件 生成 的 。 在 Maven 3 中 ， 该 插件 的 配置 内 置 在 maven-site-plugin 中 ， 
而 在 Maven 2 中 ， 该 插件 的 配置 内 置 在 核心 源码 中 。 因 此 你 不 需要 任何 
配置 就 能 让 Maven 帮 你 生成 项 目 信 息 。 该 插件 会 基于 POM 配 置 生成 下 列 
项 目 信 息 报 告 : 





XF Cabout) : 项 目 描述 。 
:持续 集成 《Continuous Integration) : 项 目 持 续集 成 服务 器 信息 。 


AXi (Dependencies) : 项 目 依 赖 信息 ， 包 括 传递 性 依赖 、 依 赖 
图 、 依 赖 许可 证 以 及 依赖 文件 的 大 小 、 所 包含 的 类 数目 等 。 


-依赖 收敛 (Dependency Convergence) : 只 针对 多 模块 项 目 生 成 ， 
提供 一 些 依赖 健康 状况 分 析 ， 如 各 模块 使 用 的 依赖 版 本 是 否 一 致 、 项 目 
中 是 否 有 SNAPSHOT 依 赖 。 


(cai FL (Dependency Management) : 基于 项 目的 依赖 管理 配置 
生成 的 报告 。 





:问题 奶 躁 (Issue Tracking) : 项 目的 问题 奶 踪 系统 信息 。 


:邮件 列表 (Mailing Lists) : 项 目的 邮件 列表 信息 。 
.插件 管理 (Plugin Management) : 项 目 所 使 用 插件 的 列表 。 
:项 目 许 可 证 (Project License) : 项 目 许可 证 信息 。 


-项目 概 述 (Project Summary) : 项 目 概述 包括 坐标 、 名 称 、 描 


Gt 





:项目 团队 (Project Team) : 项 目 团队 信息 。 


:源码 仓库 〈Source Repository) : 项 目的 源码 仓库 信息 。 














上 述 有 些 项 是 根据 项 目 己 有 的 依赖 和 插件 配置 生成 的 。 例 如 ， 依 赖 
这 一 项 就 很 有 意思 ， 除 了 依赖 坐标 、 传 递 性 依赖 以 及 依赖 图 ， 可 以 使 用 
maven-dependency-plugin 生 成 的 信息 之 外 ， 报 告 还 有 依赖 文件 细节 的 信 
息 ， 这 里 详细 罗列 了 每 个 依赖 文件 的 名 称 、 大 小 、 所 包含 文件 数目 、 类 
数目 、 包 数目 和 JDK 版 本 等 信息 ， 如 图 15-2 所 示 。 








依赖 相关 的 项 是 基于 POM 的 dependencies 和 dependencyManagement 
元 素 生成 的 ， 类 似 地 ， 其 他 项 也 都 有 其 对 应 的 POM 元 素 。Maven 不 会 任 
空 生成 信息 ， 只 有 用 户 在 POM 中 提供 了 相关 配置 后 ， 站 点 才 有 可 能 包含 
这 些 信息 的 报告 。 为 了 让 站 点 包含 完整 的 项 目 信 息 ， 需 配置 POM， 如 代 
码 清单 15-1 所 示 。 





Dependency File Details 





greenmail-1.3.1b.jar 
commons-logging-1.1.1.Jar 
activation-1.1.jar 
mail-1.4,1.jar 
junit-4.7.jar 
slf4j-api-1.3.1.jar 
spring-beans-2.5.6.jar 
spring-context-2.5.6.jar 
spring-context-support-2.5.6.jar 
spring-core-2.5.6.jar 
Total 

11 


437.18 kB 
226.91 kB 

11.94 kB 
476.84 kB 
465.76 kB 

94.61 kB 
278.80 kB 


2.26 MB 


compile: 8 compile: 1.83 MB compile: 1,432 compile: 1,264 compile: 110 
test:3 test: 433.46 kB 


test: 462 





test: 398 test: 44 


图 15-2 ”依赖 文件 细节 报告 


代码 清单 15-1 包含 完整 项 目 信 息 


的 POM 


<project xmlns = "http://maven. apache. org /POM7/4.0.0" 
xmlns:xsi = "http://www. w3 .org 2001 AMLSchema-instance" 
xsi:schemaLocation ="http://maven. apache. org/POM/4.0.0 
http://maven. apache. org/maven-v4_0_0.xsd"> 
<modelVersion >4.0.0 < /modelVersion > 
<groupId >com. juvenxu.mvnbook, account < /groupId > 
<artifactId >account-parent < /artifactId> 
< version >1.0.0-SNAPSHOT < /version > 
<packaging >pom< /packaging > 
<name >Account Parent < /name > 
<url >http://mvnbook. juvenxu. com/< /url > 
<description >A project used to illustrate Mavens features. < /description > 


<scm> 
<connection >sem:svn :http://svn. juvenxu. com/mvnboook /trunk < /connection > 
<developerConnection >scm:svn:https://svn. juvenxu. com/mvnboook / trunk 
< /developerConnection > 
<url >http://svn. juvenxu. com/mvnboook /trunk < /url > 
</scm> 


<ciManagement > 

<system >Hudson < /system > 

<url >http://ci. juvenxu. com/mvnbook < /url > 
< /ciManagement > 


<developers > 
< developer > 
<id>juven</id> 
<name >Juven Xu < /name > 
<email >juvenshun@ gmail.com< /email > 
<timezone >8 < /timezone > 
< /developer > 
< /developers > 


< issueManagement > 

<system>JIRA< /system> 

<url >http://jira, juvenxu. com/mvnbook < /url > 
< /issueManagement > 


< licenses > 
< license > 
<name >Apache License, Version 2.0 < /name > 
<url >http://www. apache. org/licenses /LICENSE2.0 < /url > 
< /license > 
< /licenses > 


= yen > 
代码 清单 15-1 中 使 用 scm 元 素 为 项 目 添 加 了 源码 仓库 信息 ， 使 用 
ciManagement 元 素 为 项 目 添加 了 持续 集成 服务 器 信息 ， 使 用 developers 





元 素 为 项 目 添加 了 项 目 成 员 团队 信息 ， 使 用 issueManagement 元 素 为 项 
目 添加 了 问题 追踪 系统 信息 ， 使 用 licenses 元 素 为 项 目 添加 了 许可 证 信 
息 。 这 时 再 重新 生成 站 点 ， 相 关 信 息 就 会 体现 在 站 点 的 项 目 信息 报告 
中 。 图 15-3 就 显示 了 一 个 典型 的 源码 仓库 信息 报告 。 


Overview 

This project uses Subversion : to manage its source code. Instructions on Subversion use can be found at http://svnbook.red-bean.com/ œ 
Web Access 

The following is a link to the online source repository. 


m/mynboook/ trunk © 


Anonymous access 
The source can be checked out anonymously from SVN with this command: 


$ svn checkout http: //svn. juvenxu. com/mvnboook/trunk account~parent 


Developer access 


Everyone can access the Subversion repository via HTTP, but Committers must checkout the Subversion repository via HTTPS. 
$ svn checkout https: //svn. juvenxu. com/mynboook/trunk account-parent 
To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password) 


$ svn commit —-username your~username -m “A message” 





图 15-3 ”项 目 源码 仓库 信息 报告 





类 似 的 项 目 信 息 报 告 读者 可 以 在 很 多 的 开源 项 目 中 看 到 ， 使 用 
Maven 站 点 来 一 致 化 开源 项 目的 信息 展现 方式 无 疑 为 用 户 获 取信 息 提 供 
了 便利 。 


有 些 时 候 ， 用 户 可 能 不 需要 生成 菜 些 项 目 信 息 项 ， 例 如 你 可 能 没有 
邮件 列表 或 者 不 想 在 站 点 中 公开 源码 仓库 信息 ， 这 时 可 以 配置 maven- 








project-info-reports-plugin 选 择 性 地 生成 信息 项 ， 如 代码 清单 15-2 所 示 。 


代码 清单 15-2 ”选择 性 地 生成 项 目 信 息 报告 


oject 

reportir 

<plugi 
<plug 


<groupIĪd >org.apache. maven. plugins < /GroupIG > 
<artifactId >maven-project-info-reports-plugin < /artifactId > 


<version >2.1.2 </version> 


ort >dependencies < /report > 
>project-team< /report > 


> issue-tracking < /report > 





ort >license < /report > 





上 述 代码 配置 了 maven-project-info-reports-plugin。 需 要 注意 的 是 ， 
项 目 报告 插件 需要 在 reporting 元 素 下 的 plugins 元 素 下 进行 配置 ， 下 一 节 
还 将 介绍 其 他 项 目 报告 插 件 ， 也 都 在 这 里 进行 配置 。 代 码 清 单 15-2 中 的 
配置 使 得 站 点 的 项 目 信 息 只 包 仿 依赖、 团队、 问题 退 踪 系统 和 许可 证 几 
项 信息 ， 读 者 可 以 根据 自己 的 实际 情况 选择 要 生成 的 项 目 信 息 。 

















15.3 ”项 目 报告 插件 


除了 默认 的 项 目 信 息 报告 ，Maven 社 区 还 提供 了 大 量 报告 插件 ， 只 
要 稍 加 配置 ， 用 户 就 能 让 Maven 自 动 生成 各 种 内 容 丰 富 的 报告 。 下 面 介 
绍 一 些 比较 常用 的 报告 插件 。 值 得 注意 的 是 ， 报 告 插 件 在 POM 中 配置 的 
位 置 与 一 般 的 插件 配置 不 同 。 一 般 的 插件 在 <project><build><plugins> F 
配置 ， 而 报告 插件 在 <project><reporting><plugins> 下 配置 。 





15.3.1 JavaDocs 


这 可 能 是 最 简单 、 也 最 容易 理解 的 报告 插件 了 。maven-javadoc- 
plugin 使 用 JDK 的 javadoc 工 具 ， 基 于 项 目的 源 代码 生成 JavaDocs 文 档 。 
该 插件 的 配置 如 代码 清单 15-3 所 示 。 





代码 清单 15-3 ”配置 maven-javadoc-plugin 插 件 


<reporting > 
<plugins > 
<plugin> 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-javadoc-plugin < /artifactId> 
<version >2.7 </version > 
</plugin > 


< /plugins > 
< /reporting > 


基于 上 述 简 单 的 配置 ， 当 用 户 使 用 mvn site 命 令 生成 站 点 时 ， 台 能 
得 到 项 目 主 源码 和 测试 源码 的 JavaDocs 文 档 ， 如 图 15-4 所 示 。 


Account Captcha 
Last Published; 2010-07-18 I ANET 
Project Documentation 
» Project Information Generated Reports 
™ Project Reports 
Test Jay aDocs 


This document provides an overview of the various reports that are 
Built by: “Wm 


automatically generated by Maven wœ Each report is briefly described 
Maven below. 


Overview 


JavaDocs JavaDoc API documentation. 


Test JavaDocs Test JavaDoc API documentation. 





图 15-4 插件 报告 列表 


图 15-4 左 侧 的 导航 栏 有 两 个 类 别 ，Project Information 包 含 了 15.2 节 


讲述 的 各 类 基本 信息 ，Project Reports 则 包含 其 他 插件 生成 的 报告 。 这 里 


能 看 到 maven-javadoc-plugin 生 成 JavaDocs 和 Test JavaDocs 文 档 ， 单 击 相 
应 链接 惑 能 得 看 具体 文档 ， 如 网 15-5 所 示 。 








所 有 类 = 

AccountCaptchaException KH ESA H 已 过 时 索引 帮助 
AccountCaptchaService 上 一 个 类 下 一 个 类 EL 无 框架 
AccountCaptchaServicelmp! 摘要 : ME | 字段 | 构造 方法 | 方法 详细 信息 : 字段 1 构造 方法 | 方法 
RandomGenerator Ci ire aie de A ok it Pian pares tee ici 














con. juvenxu. myvnbook. account. captcha 


接口 AccountCaptchaService 
所 有 已 知 实现 类 : 


AccountCaptchaServicelInpl 








public interface AccountCaptchaService 


enerateCaptchalmage (String captchaKey) 


String] generateCaptchaKey() 


getPreDefinedTexts() 
void! setPreDefinedTexts(List<String> preDefinedTexts) 
validateCaptcha(String captchaKey, String captchaValue) 


图 15-5 ”JavaDocs 文 档 











在 生成 项 目 站 点 文档 的 时 候 ， 一 个 音 见 的 问题 是 : 用 户 往往 只 希望 
在 聚合 项 目 一 次 性 生成 融合 了 所 有 模块 信息 的 文档， 而 不 是 为 每 个 模块 
单独 生成 ， 原 因 就 是 为 了 方便 。 用 户 总 是 希望 在 一 个 地 方 看 到 尽 可 能 全 
面 的 信息 ， 而 非 不 停 地 单 击 链接 。 笠 运 的 是 ，maven-javadoc-plugin 考 不 
到 了 这 一 点 ， 使 用 该 插件 的 最 新 版 本 ， 用 户 无 须 任何 额外 的 配置 ， 丈 能 
在 聚合 项 目的 站 点 中 得 到 包含 所 有 模块 的 JavaDocs， 配 置 见 代码 清单 15- 
3。 














15.3.2 Source Xref 


如 果 能 够 随时 随地 地 打开 浏览 器 访问 项 目的 最 新 源 代 码 ， 那 无 疑 会 
方便 团队 之 间 的 交流 。maven-jxr-plugin 能 够 帮助 我 们 完成 这 一 目标 ， 在 
生成 站 点 的 时 候 配 置 该 插件 ，Maven 就 会 以 Web 页 面 的 形式 将 Java 源 代 
码 展 现 出 来 。 该 插件 的 配置 如 代码 清单 15-4 所 示 。 


代码 清单 15-4 配置 maven-jxr-plugin 插 件 


< reporting > 
<plugins > 
<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactid >maven-jxr-plugin < /artifactId> 
srsion >2.2 </version > 


< VE = 
< /plugin> 


</ jy lugins > 
若 想 在 聚合 模块 整合 所 有 的 源码 ， 则 需 添 加 额外 的 aggregate 配 置 ， 
如 代码 清单 15-5 所 示 。 


代码 清单 15-5 在 聚合 项 目 配置 maven-jxr-plugin 插 件 


<reporting > 
<plugins > 
<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactid >maven-jxr-plugin < /artifactid> 
<version >2.2 < /version > 
<configuration > 
<aggregate >true < /aggregate > 
< /configuration > 
</plugin > 
< /plugins > 
< /reporting > 


生成 的 源码 交叉 引用 报告 如 图 15-6 所 示 。 


在 这 个 源码 交叉 引用 文档 中 ， 所 有 源码 文件 都 通过 超 链接 相连 ， 如 
果 之 前 配置 了 JavaDocs 报 告 ， 用 户 还 能 直接 转 到 源码 文件 对 应 的 


JavaDoc. 


All Classes 


Packages package com. juvenxu. mvnbook, account. captcha; 
import java. awt. image. BufferedImage; 

import java. io. ByteArrayOutput Stream; 

import java. io. IOException; 

import java. util. HashMap. 

import java.util.List; 

import java.util.Map; 

import java.util. Properties; 


com nx kaccountcaptch: 
com juvenxu.mvnbook account email 
com juvenxu.mvnbook account persist 


comian mvnhook account canica 
All Classes . 
import javax. imageio. ImageI0; 


Account 
AccountCaptchaException 


import org. springframework. beans. factory. InitializingBean: 


import com. google. code. kaptcha. impl. DefaultKaptcha; 
import com. google. code. kaptcha. util. Config; 





AccountCaptchaService 
AccountCaptchaServicelmp! 
AccountEmailException 
AccountEmailService 
AccountEmailServicelmp! 
AccountPersistException 
AccountPersistService 
AccountPersistServicelmp! 
AccountService 


public class it Capt 
implements AccountCaptchaService, InitializingBean 
{ 


private DefaultKaptcha producer; 








private Map<String, String> captchaMap = new HashMap<String, String>(); 


private List<String> preDefinedTexts; 


eption private int textCount = 0; 


public void afterPropertiesSet () 
throws Exception 


{ 
producer = new DefaultKaptcha() ; 


ActivateServiet 
CaptchalmageServiet 
LoginServiet 
RandomGenerator 
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图 15-6 ”源码 交叉 引用 文档 





15.3.3 CheckStyle 


CheckStyle 是 一 个 用 来 帮助 Java 开 发 人 员 遵 循 编 码 规范 的 工具 ， 能 
根据 一 套 规 则 自动 检查 Java 代 码 ， 使 得 团队 能 够 方便 地 定义 上 自己 的 编码 
规范 。 关 于 该 工具 的 详细 信息 可 以 访问 http:/checkstyle.sourceforge.net/ 
进行 了 解 。 





要 让 Maven 在 站 点 中 生成 CheckStyle 报 告 ， 只 需要 配置 maven- 
checkstyle-plugin， 如 代码 清单 15-6 所 示 。 


代码 清单 15-6 ”配置 maven-checkstyle-plugin 插 件 


<reporting > 
<plugins > 
<plugin > 
<grouplid >org. apache. maven. plugins < /groupId > 
<artifactId >maven-checkstyle-plugin < /artifactId> 
<version >2.5 < /version > 
< /plugin > 


< /plugins > 
< /reporting > 


运行 mvn site 命 令 后 ， 就 能 得 到 图 15-7 所 示 的 CheckStyle 报 告 。 


Documentation Checkstyle Results 


The following document contains the results of Checkstyle œ, | 


Summary 


ook mt/pers Ac Int.ja 

om/juvenxu/my 6 ok/account/persis YA aes i stEx aripa java 
om/juvenxu/mvnbook/account/persist/ ountPers erv a 

com/juvenxu/mv ha ount/persist/ oneal ersiatServ aa java 


Rules 


JavadocPackage 

+ allowLegacy: “true” 
NewlineAtEndOfFile 
Translation 


FileLength 
FileTabCharacter 





图 15-7 CheckStyled 4 


默认 情况 下 ，maven-checkstyle-plugin 会 使 用 Sun 定 义 的 编码 规范 ， 
读者 能 够 选择 其 他 预 置 的 规则 。 也 可 以 自 定义 规则 ，maven-checkstyle- 
plugin 内 置 了 四 种 规则 : 


-config/sun_checks.xml: Sun 定 义 的 编码 规范 〈 默 认 值 ) 。 
:config/maven_checks.xml: Maven 社 区 定义 的 编码 规范 。 
-config/turbine_checks.xml: Turbine 定义 的 编码 规范 。 
:config/avalon_checks.xml: Avalon 定 义 的 编码 规范 。 


用 户 可 以 配置 maven-checkstyle-plugin 使 用 上 述 编码 规范 ， 如 代码 清 


单 15-7 所 示 。 


He 


代码 清单 15-7 配置 maven-checkstyle-plugin 使 用 非 默 认 编 码 规 





eporting > 
plugins > 
<plugin > 

groupId he.maven.plugins </groupId > 
artifa 1 sckstyle-plugin < /artifactid > 
version 

<configuration > 
<configLocation >config/maven_checks. xml < /configLocation > 

< /configuration > 

‘plugin > 


通常 用 户 所 在 的 组 织 会 有 目 己 的 编码 规范 ， 这 时 就 需要 创建 目 己 的 





checkstyle 规 则 文件 。 如 在 src/main/resources/ 目 录 下 定义 一 个 


checkstyle/my_checks.xml 文 件 ， 然 后 配置 
<configLocation>checkstyle/my_checks.xml</configLocation>& HJ . 
maven-checkstyle-plugin 实 际 上 是 从 ClassPath 载 入 规则 文件 ， 因 此 对 于 它 
来 说 ， 无 论 规则 文件 是 在 当前 项 目 中 还 是 在 依赖 文件 中 ， 处 理 方 式 都 是 
一 样 的 。 








对 于 多 模块 项 目 来 说 ， 使 用 maven-checkstyle-plugin 会 有 一 些 问题 。 
首先 ，【〔 到 本 书 编写 为 止 〉》maven-checkstyle-plugin 还 不 支持 报告 聚合 。 
也 就 是 说 ， 用 户 无 法 在 聚合 项 目的 报告 中 得 到 所 有 模块 的 CheckStyle 报 
告 。 想 要 在 各 个 模块 中 重用 自 定义 的 checkstyle 规 则 还 需要 一 些 额 外 的 
配置 。 具 体 过 程 如 下 : 


1) 创建 一 个 包含 checkstyle 规 则 文件 的 模块 : 


checkstyle/pom. xml 
checkstyle/src/main/resources /checkstyle/my-checks. xml 


2) 在 聚合 模块 配置 maven-checkstyle-plugin 依 赖 该 模块 : 


<build> 
<plugins > 
<plugin> 
<groupld >org. apache. maven. plugins < /groupId > 
<artifactId >maven-checkstyle-plugin < /artifactId > 
<version >2.5 < /version > 
< dependencies > 
< dependency > 
<groupid >com. juvenxu. mvnbook < /groupId > 
<artifactId >checkstyle < /artifactId > 
<version >1.0 < /version > 
< /dependency > 
< /dependencies > 
</plugin > 
< /plugins > 
< /build> 


3) 在 聚合 模块 配置 maven-checkstyle-plugin 使 用 模块 中 的 checkstyle 
规则 : 


<reporting > 
<plugins > 
<plugin > 
<groupId >org. apache. maven. plugins < /GroupIG > 
<artifactid >maven-checkstyle-plugin < /artifactid> 
<version >2.5 </version > 
<configuration > 
<configLocation >checkstyle/my_checks. xml < /configLocation > 
< /configuration > 
< /plugin > 
< /plugins > 
< /reporting > 


原理 就 是 先 创 建 一 个 包含 自 定 义 规则 文件 的 依赖 ， 然 后 将 该 依赖 加 
入 到 项 目的 ClassPath 中 ， 最 后 从 ClassPath 载 入 规则 文件 。 


15.3.4 PMD 


PMD 是 一 款 强大 的 Java 源 代码 分 析 工 具 ， 它 能 够 寻找 代码 中 的 问 
题 ， 包 括 潜在 的 bug、 无 用 代码 、 可 优化 代码 、 重 复 代码 以 及 过 于 复杂 
的 表达 式 。 关 于 该 工具 的 详细 信息 可 以 访问 http:/pmd.sourceforge.net/ 进 
行 了 解 。 


要 让 Maven 在 站 点 中 生成 PMD 报 告 ， 只 需要 配置 maven-pmd-plugin 
如 下 : 


<plugins > 


<plugin:; 
<groupIid >org. apache. maven. plugins < /groupId > 
< mee gs maven -pm -plugin < /artifactIid> 
< version >2.5 < /version: 
</plugin > 


< /plugins > 
< /reporting > 


运行 mvn site 之 后 ， 就 能 得 到 图 15-8 所 示 的 PMD 报 告 。 


Project 
Documentation PMD Results 


The following document contains the results of PMD 4.2.5. 





Test Source Xref 


com/juvenxu/mvnbook/account/persist/AccountPersistServiceImpl.java 


Error while parsing D:\git-juven\maven-book\code\ch-15\account-aggregator\account- 
persist\src\main\java\com\juvenxu\mvnbook\account\persist\AccountPersistServiceImpl.java: Can't 
use annotations when running in JDK 1.4 mode! 

Error while parsing D;\git-juven\maven-book\code\ch-15\account-aggregator\account- 
persist\src\main\java\com\juvenxu\mynbook\account\persist\AccountPersistServiceImpl.java: Can't 
use annotations when running in JDK 1.4 mode! 

Error while parsing D:\git-juven\maven-book\code\ch-15\account-aggregator\account- 
persist\src\main\java\com\juvenxu\mvnbook\account\persist\AccountPersistServiceImpl.java: Can't 
use annotations when running in JDK 1.4 mode! 





图 15-8 ”PMD 报告 


需要 注意 的 是 ， 除 了 PMD 报 告 之 外 ，maven-pmd-plugin 还 会 生成 一 
个 名 为 CPD 的 报告 ， 该 报告 中 包含 了 代码 拷贝 粘贴 的 分 析 疆 


PMD 包 含 了 大 量 的 分 析 规 则 ， 读 者 可 以 访问 
http://pmd.sourceforge.net/rules/index.html 查 看 这 些 规则 。PMD 默 认 使 用 
的 规则 为 rulesets/basic.xml、rulesets/unusedcode.xml 和 和 
rulesets/importss.xml。 要 使 用 其 他 的 规则 ， 可 以 配置 maven-pmd-plugin 
插件 ， 如 代码 清单 15-8 所 示 。 





代码 清单 15-8 ”配置 maven-pmd-plugin 使 用 非 默 认 分 析 规 则 


<reporting > 
<plugins > 
<plugin > 
<groupiId>org. apache. maven. plugins < /groupIid > 
<artifactid >maven-pmd-plugin < /artifactId> 
<version >2.5 </version > 
< configuration > 
<rulesets > 
<ruleset >rulesets/braces. xml < /ruleset > 
<ruleset >rulesets /naming, xml < /ruleset > 
<ruleset >rulesets/strings.xml < /ruleset > 
< /rulesets > 
< /configuration > 
< /plugin > 
< /plugins > 
< /reporting > 





maven-pmd-plugin 支 持 聚 合 报告 ， 只 需要 如 下 配置 aggregate 参 数 即 


<reporting > 
<plugins > 
<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactid >maven-pmd-plugin < /artifactId> 
<version >2.5 < /version > 
<configuration > 
<aggregate >true < /aggregate > 
< /configuration > 
< /plugin > 
</plugins > 
< /reporting > 


15.3.5 ChangeLog 


maven-changelog-plugin 能 够 基于 版 本 控制 系统 中 就 近 的 变更 记录 生 
成 三 份 变 更 报告 ， 它 们 分 别 为 : 


‘Change Log: 基于 提交 的 变更 报告 ， 包 括 每 次 提交 的 日 期 、 文 
件 、 作 者 、 注 释 等 信息 。 


‘Developer Activity: 基于 作者 的 变更 报告 ， 包 括 作者 列表 以 及 每 个 
作者 相关 的 提交 次 数 和 涉及 文件 数目 。 


‘File Activity: 基于 文件 的 变更 报告 ， 包 括 变更 的 文件 列表 及 每 个 
文件 的 变更 次 数 。 


想 要 生成 项 目的 变更 报告 ， 首 先 需要 配置 正确 的 SCM 信 息 赔 ， 如 


<connection >scm:svn:http://192.168.1.103 /app/trunk < /connection > 
< developerConnection >scm:svn:https://192.168.1.103 /app/trunk < /develo- 
perConnection > 
<url> http://192.168.1.103 /account /trunk < /url > 
Sh Ss 


< /project > 


有 了 SCM 配 置 ， 就 可 以 配置 maven-changelog-plugin 生 成 变更 报告 。 
如 下 : 


< reporting > 
<plugins > 
<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactiId >maven-changelog-plugin < /artifactId> 
<version >2.2 < /version > 
< / plugin > 
< /plugins > 
</reporting > 


生成 的 变更 报告 如 图 15-9 所 示 。 





默认 情况 下 ，maven-changelog-plugin 生 成 最 近 30 天 的 变更 记录 ， 不 
过 用 户 可 以 修改 该 默认 值 。 如 下 : 


Change Log Report 


Total number of changed sets: 1 


“Changes between 2010-04-28 and 2010-05-29 


Total commits: 12 
Total number of files changed: 8 


2010-05-25 Dennis /maven/plugins/tags/maven-changelog-plugin-2.2 @ v 948185 © 
21:21:19 Lundberg 


[maven-scm] copy for tag maven-changelog-plugin-2 @.2 
2010-05-25 Dennis /maven/plugins/trunk/maven-changelog-plugin/pom.xml © v 948184 @ 


21:21:07 Lundber 
[maven-release-plugin] prepare release maven-changelog-plugin-2 路 .2 


2010-05-25 Dennis /maven/plugins/trunk/maven-changelog-plugin/pom.xml m v 948176 w 
21:11:51 Lundberg 


Upgrade to maven-plugins parent 18. 
2010-05-25 Dennis /maven/plugins/trunk/maven-changelog-plugin/pom.xml mw v 948173 © 


21:08:46 Lundberg 
Add used but undeclared dependencies. 


2010-05-25 Dennis /maven/plugins/trunk/maven-changelog-plugin/pom.xml @ v 948152 © 
20:24:39 Lundberg 


Remove element that was mistakenly added in r890138. 


2010-05-13 hboutemy = /maven/plugins/trunk/mayen-changelog-plugin/pom.xml @ v 943737 © 
00:44:31 





updated reporting plugins dependencies: maven-reporting-api 3.0 and maven-reporting-imp! 2.0.5 


图 15-9 ”变更 报告 


< reporting > 
<plugins > 
<plugin> 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactid >maven-changelog-plugin < /artifactId> 
<version >2.2 </version > 
<configuration > 
<type >range < /type > 
<range >60 < /range > 
< /configuration > 
< /plugin > 
</plugins > 
< /reporting > 


[1] 如 果 不 熟悉 该 配置 ， 可 以 回顾 13.4 节 。 


15.3.6 Cobertura 


10.6.2 节 已 经 介绍 过 用 Cobertura 生 成 测试 覆盖 率 报 告 ， 现 在 介绍 如 
何 将 该 报告 集成 到 项 目 站 点 中 。 





要 在 Maven 站 点 中 包含 Cobertura 测 试 覆 盖 率 报告 ， 只 需要 配置 


cobertura-maven-plugin。 如 下 : 


<reporting > 
<plugins > 
<plugin > 
<groupId >org.codehaus.mojo < /groupid > 
<artifactId >cobertura-maven-plugin < /artifactiId> 
<version >2.4 < /version> 
</plugin > 
< /plugins > 
< /reporting > 


生成 的 Cobertura 测 试 履 盖 率 报告 如 图 15-10 所 示 。 


Packages Coverage Report - com.juvenxu.mvnbook.account.captcha 


All 
com.juvenxu.mynbook.account.captch! Package # Classes Line Coverage Branch Coverage Complexity 


nt. 4 78% 36/46 @ 75% 9/12 ier 1.8 





Classes in this Package © Line Coverage Branch Coverage Complexity 
AccountCaptchaException oco (As N/A N/A 














= AccountCaptchaService N/A | N/A | N/A N/ i 
com.juvenxu.mvnbook.account.c A zi h — 85% C 30/5 E 70% | 
RandomGenerator 85%| 6/7 B 100% 2/2 
Classes 


AccountCaptchaException (0%) Report generated by Cobertura 1.9.4.1 on 10-7-21 下 午 2:36， 
AccountCaptchaService (N/A) 

AccountCaptchaServiceImp! (85%) 

RandomGenerator (85%) 























图 15-10 “Cobertura 测 试 履 盖 率 报 告 


可 以 从 图 15-10 中 看 到 每 个 包 、 每 个 类 的 代码 行 覆 盖 率 和 分 文 覆盖 
率 ， 单 击 具 体 的 类 还 能 看 到 该 类 代码 的 具体 覆盖 情况 。 可 惜 的 是 ， 到 本 
书 编写 时 为 止 ，cobertura-maven-plugin 还 不 支持 报告 聚合 ， 因 此 用 户 无 
法 在 聚合 模块 查看 所 有 模块 的 测试 覆盖 情况 。 


15.4 Ae Cub oh 





Maven 生 成 的 站 点 非常 灵活 ， 除 了 本 章 前 面 提 到 的 标准 项 目 信 息 报 
告 和 其 他 插件 生成 的 报告 ， 用 户 还 能 够 自 定义 站 点 的 布局 和 外 观 。 这 些 
特性 能 让 用 户 创建 出 更 适合 自己 的 ， 更 有 个 性 的 Maven 站 点 。 


15.4.1 站 点 描述 符 


要 目 定 义 站 点 外 观 ， 用 户 必须 创建 一 个 名 为 site.xml 的 站 点 描述 符 文 
件 ， 且 默认 该 文件 应 该 位 于 项 目的 src/site 目 录 下 。 该 站 点 描述 符 文件 是 
由 XML Schema 约束 定义 的 ， 相 关 的 xsd 文 件 位 于 


http://maven.apache.org/xsd/decoration-1.0.0.xsd. 
一 个 简单 的 站 扣 描 述 答 文件 如 代码 清单 15-9 所 示 。 
代码 清单 15-9 ”站 点 描述 符 文件 


<?xml version = "1.0" encoding = "UTF-8"?> 
<project xmins = "http: //maven. apache. org/DECORATION/1.0.0" 
xmins:xsi = “http://www. w3.org/2001 /XMLSchema-instance" 
xSi:schemaLocation = “http://maven. apache. org /DECORATION/1.0.0 
http://maven. apache. org/xsd/decoration-1.0.0.xsd" > 
<bannerLeft > 
<name >Account < /name > 
<srce > images /apacheanaven-project.png < /sre > 
<href >http://maven. apache. org < /href > 
< /bannerLeft > 
< body > 
<menu ref ="reports"/ > 
< /body > 
<skin> 
< groupId >com. googlecode. fluido-skin < /groupId > 
<artifactid >fluido-skin < /artifactId> 
<version >1.3 < /version > 
< /skin > 
< /project > 


TAHIR FT CTE RE SC ah A SK I AP, IS SES OA 
及 一 个 站 点 皮肤 。 下 面 详 细 介绍 各 类 可 在 站 点 描述 符 中 定义 的 内 容 。 


15.4.2” 头 部 内 容 及 外 观 


默认 情况 下 ，Maven 站 点 的 标题 来 自 于 POM 中 的 name 元 素 值 ， 用 户 
可 以 配置 站 点 描述 符 project 元 素 的 name 属 性 来 更 改 此 标题 。 如 下 : 





<project name =" A Project for Maven Book" > 


< /project > 


显示 效果 如 图 15-11 所 示 。 


A Project for Maven Book - Generated Reports 


PA A Project for Maven B... 


€ Cv file:///D:/git-juven/maven-book/cq 





图 15-11 自 定 义 站 点 标题 的 效果 


如 果 不 进 行 额 外 的 配置 ， 站 点 头 部 左边 会 显示 项 目的 名 称 ， 但 是 用 
户 可 以 使 用 bannerLeft 元 素 配 置 该 位 置 显示 自 定义 的 横幅 图 片 。 类 似 
地 ，bannerRight 元 素 能 用 来 配置 显 式 在 头 部 右边 的 横幅 图 片 。 具 体 配置 
如 下 : 











<name >maven < /name > 
<src >http://maven. apache. org/images /apache-maven-project.png < /sre> 
<href >http://maven. apache. org < /href > 
< /bannerLeft > 
<bannerRight > 
<name >java < /name > 
< src >images/java. jpg < /src > 
<href >http://www. java.com< /href > 
< /bannerRight > 


</project > 


上 述 代 码 为 头 部 配置 了 两 个 横幅 图 片 ， 左 边 的 图 片 直接 引用 了 
Maven 站 点 ， 而 右边 则 使 用 了 本 地 图 片 。 显 示 效 果 如 图 15-12 所 示 。 


se Apache Maven Project 


http://maven.apache.org/ 


Last Published: 2010-07-23 





图 15-12 ”站 点 头 部 横幅 图 片 显 示 效 果 


需要 注意 的 是 ， 上 述 Java 图 片 的 src 为 images/java.jpg， 是 一 个 本 地 
图 片 ， 所 有 站 点 使 用 的 本 地 Web 资 源 都 必须 位 于 src/site/resources 目 录 
下 。 到 目前 为 止 ， 该 站 点 的 目录 结构 是 这 样 的 : 


-Srce/ 
+ Site/ 
+ resources/ 
| + images/ 
+ java,jpg 





除了 标题 和 头 部 横幅 图 片 外 ，Maven 用 户 还 能 够 配置 是 否 显示 站 点 
的 最 近 发 布 时 间 和 版 本 。 如 下 : 





<project > 
<version position = "right "/> 
<publishDate position = "right"/> 


</project > 


这 里 的 position 可 用 的 值 包括 none、left、right、navigation-top、 
navigation-bottom 和 bottom， 它 们 分 别 表示 不 显示 、 头 部 左边 、 头 部 右 


边 、 导 航 边栏 上 方 、 导 航 边 栏 下 方 和 底部 。 
Maven 站 点 还 文 持 面包 居 导 航 。 相 关 配 置 如 下 : 


<project > 
< body > 
< breadcrumbs > 


<item name = "Maven" href 
"href = "http://www. juvenxu. com" /> 


"http://maven. apache. org"/> 
<item name = "Juven Xu 
< /breadcrumbs > 
< / body > 


: 
< /project > 


显示 效果 如 图 15-13( 图 中 还 包括 了 发 布 日 期 和 版 本 ) 所 示 。 


—_ 
— 


Java 
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图 15-13 SAA eS Se Se a 


15.4.3 ”皮肤 





如 果 党 得 目 定义 站 点 标题 、 横 幅 图 片 和 面包 居 导 航 等 内 容 还 无 法 满 
足 自 己 的 个 性 化 需求 ， 这 时 也 许可 以 考虑 选择 一 丈 非 默认 的 站 点 皮肤 ， 
以 将 自己 的 站 点 与 其 他 站 点 很 明显 地 区 分 开 来 。 





目 定 义 站 点 皮肤 分 为 两 步 : 第 一 步 是 选择 要 使 用 的 站 点 皮肤 构件 ; 
二 步 是 配置 站 点 描述 符 的 skin 元 又 使 用 该 构件 。 


Maven È tet T SRE, CRA: 
-org.apache.maven.skins:maven-classic-skin 
-org.apache.maven.skins.maven-default-skin 


‘org.apache.maven.skins.maven-stylus-skin 


其 中 ，maven-default-skin 是 站 点 的 默认 皮肤 ， 读 者 可 以 访问 中 央 仓 
库 以 了 解 这 些 皮肤 的 最 新 版 本 1。 


除了 官方 的 皮肤 ， 互 联网 上 还 有 大 量 的 第 三 方 用 户 创 建 的 站 点 及 
肤 。 这 里 笔者 要 介绍 一 款 托管 在 GoogleCode 上 的 名 为 ftuido-skin 的 皮 
肤 ， 它 非常 清 严 、 简 洁 ， 读 者 可 以 访问 该 项 目 主 页 了 解 其 最 新 的 版 


下 面 就 以 ftuido-skin 为 例 ， 配 置 站 点 皮肤 。 编 辑 site.xml 如 下 : 


<project > 
<skin > 
< groupId >com. googlecode. fluido-skin < /groupid > 
<artifactl ad>fluido-skin < /artifactId> 
<version >1.3 </version > 
< /skin> 
< /project > 





图 15-14 显 示 了 使 用 了 fluido-skin 皮 肤 后 的 站 点 显示 效果 ， 看 起 来 
默认 的 皮肤 感觉 很 不 一 样 。 


Ap pache Maven Project 
http://maven.apache.org/ 
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Project Generated Reports 

Documentation 
*Project Information This document provides an overview of the various reports that are automatically generated by Maven ™ Each 

“Project Reports report is briefly described below. 
Checkstyle 
Cobertura Test 
ahi Overview 
CPD Report 
JavaDocs 
PMD Report à 
Source Xref Checkstyte Report on coding style conventions. 
Test JavaDocs Cobertura Test Coverage Cobertura Test Coverage Report. 


Test Source Xref 
CPD Report Duplicate code detection. 


Built by: š 
maven JavaDocs JavaDoc API documentation. 





PMD Report Verification of coding rules. 





Source Xref HTML based, cross-reference version of Java source code, 
Test JavaDocs Test JavaDoc API documentation. 


Test Source Xref HTML based, cross-reference version of Java test source code. 


Copyright © 2010. All Rights Reserved. 








图 15-14 使 用 了 fluido-skin 皮 肤 的 站 点 


[1] 请 参考 : http:/repol.maven.org/maven2/org/apache/maven/skins/。 


[2] 请 参考 : http://code.google.com/p/fluido-skin/. 


15.4.4 “导航 边栏 


如 宁 用 户 不 目 定义 站 点 描述 符 文 件 ， 页 面 左 边 的 边栏 只 会 显示 包含 
项 目 信息 报告 和 其 他 报告 的 染 单 。 然 而 该 导航 栏 内 容 也 是 能 够 自 定 义 
的 ， 用 户 可 以 在 这 里 创建 其 他 亲 单 。 


要 在 导航 边栏 加 入 目 定 义 某 单 ， 只 需要 编辑 站 点 描述 符 中 body 元 象 
下 的 menu 子 元 隶 。 如 代码 清单 15-10 所 示 。 


代码 清单 ”15-10 


project 
body > 
<menu name = {project.name}" 
<item name = "Int roducat ion" href = “introduction, html"/> 
<item name = "Usage" href = “usage. html "/> 
<item name = "FAQ" href = "faq. html1 "/> 


< /menu > 


<menu name = "Examples" > 
<item name = "Example i" href = "example _1. html 
<item name = "Example 2" href = "example 2.ht 

< /menu > 


"reports"/> 





上 述 代码 中 定义 了 三 个 菜单 ， 分 别 为 ${projectname}、Examples 和 


reports. 





Fi PSL BEA Maven VE, wih ak AF A A Maven Jag HE 
被 自动 解析 至 对 应 的 值 。 因 此 这 里 的 ${project.name} 在 站 点 中 会 被 显示 





成 项 目 名 称 ， 该 菜单 包含 了 3 个 子 项 ， 分 别 为 Introduction、Usage 和 
FAQ， 每 个 子 项 链接 一 个 html 文 件 (15.5 节 将 介绍 如 何 创建 这 些 html 页 
面 ) 。 





第 二 个 沫 单 名 称 是 Examples， 包 含 两 个 子 项 Example 1 和 Example 
也 分 别 链接 两 个 html 页 面 。 





最 后 一 个 沫 单 比较 特殊 ， 它 使 用 的 是 ref 属 性 而 非 hame 属 性 ，ref 用 
来 引用 Maven 站 点 默认 生成 的 页 面 。 例 如 ， 这 里 的 reports 表 示 引 用 项 目 
报告 菜单 。 除 此 之 外 ， 还 有 两 个 可 用 的 ref 值 : parent 表 示 包 含 父 模 块 链 
接 的 表 单 ，modules 表 示 一 个 包含 所 有 子 模块 链接 的 菜单 。 


基于 代码 清单 15-10 生 成 的 站 点 如 图 15-15 所 示 。 


Account Captcha Generated Reports 


This document provides an overview of the various reports that are automatically generated by Maven © Each report is briefly 
ce described below 
Examples 

Example 1 

Example 2 Overview 
Project Documentation 


Project Information 


“Project Reports 
Checkstyle Checks tyle Report on coding style conventions. 


Cobertura Test Cobertura Test Coverage Cobertura Test Coverage Report. 
CPD Report Duplicate code detection. 
JavaDocs JavaDoc AP) documentation. 
PMD Report Verification of coding rules 
Source Xref HTML based, cross-reference version of Java source code. 
Te Test JavaDoc API documentation. 


Test Source Xref HTML based, cross-reference version of Java test source code. 


Copyright © 2010. All Rights Reserved 





图 15-15 HEFL 


15.5 ”创建 日 定义 页 面 


15.4 节 介绍 了 如 何 目 定义 站 点 导航 菜单 并 链接 至 特定 的 html 页 面 ， 
本 节 介 绍 如 何 创建 自 定 义 的 站 点 页 面 。 到 目前 为 止 ，Maven 支 持 得 比较 
好 的 两 种 文档 格式 为 APT 和 FML。 


APT (Almost Plain Text) 是 一 种 类 似 于 维基 的 文档 格式 ， 用 户 可 
以 用 它 来 快速 地 创建 简单 而 又 结构 丰富 的 文档 。 例 如 ， 创 建 一 个 对 应 于 
15.4.4 节 提 到 的 introduction.html 的 APT 文 要 ， 首 先 要 记 住 的 是 : 所 有 
APT 文 档 必须 位 于 src/site/apt/ 目 录 。 这 里 创建 文件 introduction.apt， 内 容 
见 代码 清单 15-11。 





代码 清单 15-11 创建 APT 文 档 


Introduction 


Juven Xu 


2010-07-20 


Apache Maven is a software project management and comprehension tool... 
Core Maven Concepts 
+ Coordinates and Dependency 


descriptions for maven coordinates and dependnecy... 


* Central Repository 


X 


Internal Repository Service 
* Plugin and Lifecycle 


descriptions for maven plugin and lifecycle... 


代码 清单 15-11 的 第 一 部 分 是 标题 ， 它 们 必须 缩 进 ， 且 用 多 个 连 字 
号 相隔 。 在 接 下 来 的 内 容 中 ,，“What is Maven? ”和 “Core Maven 
Concepts” 没 有 缩 进 ， 它 们 是 一 级 小 节 。“Whatis Maven? ”下 面 的 内 容 有 
缩 进 ， 表 示 一 个 段落 。 未 缩 进 的 且 以 星 号 开头 的 部 分 表示 二 级 小 节 ， 因 
此 上 述 代 码 中 有 Coordinate and Dependency、Repository 和 Plugin and 
Lifecycle 3 个 二 级 小 节 ， 它 们 都 包含 了 一 些 段落 ， 其 中 Repository 下 面 有 
包含 三 个 项 的 列表 ， 它 们 用 缩 进 的 星 号 表示 。 


上 述 代码 展示 了 如 何 编写 一 个 简单 的 APT 文 档 。 笔 者 没有 详细 介绍 
所 有 APT 文 档 格式 的 语法 ， 如 果 读 者 有 需要 ， 可 以 参 
4 http://maven.apache.org/doxia/references/apt-format.html. 


上 述 APT 文 档 展 现 后 的 效果 如 图 15-16 所 示 。 


What is Maven? 


Apache Maven is a software project management and comprehension tool... 


Core Maven Concepts 


Coordinates and Dependency 


descriptions for maven coordinates and dependnecy... 


Repository 


There are many kinds of repositories: 
è Local Repository 
es Central Reposito 
è Internal Repository Service 


Plugin and Lifecycle 


descriptions for maven plugin and lifecycle... 





图 15-16 ”APT 文 档 效果 


FML (FAQ Markup Language) 是 一 种 用 来 创建 FAQ (Frequently 
Asked Questions， 常 见 问题 解答 页 面 的 XML 文 档 格式 ， 下 面 创 建 一 个 
对 应 于 15.4.4 广 提 到 的 faq.html 页 面 的 FML 文 档 。 就 像 APT 文 档 需 要 放 到 
src/site/apt/ 目 录 一 样 ，FML 文 档 需 要 放 到 src/site/fml/ 目 录 。 在 这 里 创建 
文件 faq.fml， 如 代码 清单 15-12 所 示 。 


代码 清单 15-12 ”创建 FML 文档 


<?xml version = "1.0" encoding = "UTF-8"?> 

< faqs xmlns = “http://maven. apache. org/FML/1.0.1" 
xmlns:xsi = "http: //www.w3.org/2001 /XMLSchema-instance" 
xSi:schemaLocation = “*http://maven. apache. org/FML/1.0.1 
http://maven. apache. org/xsd/fml-1.0.1.xsd" 
title = "Frequently Asked Questions" 
toplink = "false"> 


<part id="install"> 
<title>Install </title> 
< faq id = "download" > 
< question >Where to Download? < /question > 
<answer > 
<p >Maven: http://maven. apache. org/download. html </p> 
<p >Nexus: http://nexus. sonatype. org/downloadmexus.htmi < /p > 
< f/answer > 
</faq> 
< fag id ="do-install 
< question >How to Install? «< /question > 
<answer > 
<p >Description on the installation steps... </p> 
< f/answer > 
</fag> 
</part > 


<part id="run"> 
<title>Run</title> 
< faq id= "how-install" 


< question >How to Run?< /question > 
<answer > 
p >Description on the installation steps...</p> 
< /answer > 
</faq> 
< /part > 
< /faqs > 


上 述 XML 文 档 的 根 元 素 为 faqs， 该 元 素 的 title 属 性 定义 了 文档 的 标 

。 根 元 素 下 面 使 用 part 元 素 定义 了 两 个 文档 部 分 ， 第 
二 个 是 run。 每 个 文档 部 分 有 自己 的 标题 ， 以 及 用 fag 元 素 定 义 的 问题 项 
目 ，faq 的 子 元 素 question 用 来 定义 问题 ， 子 元 素 answer 用 来 定义 答案 ， 
这 种 结构 是 非常 清晰 的 。 同 样 地 ， 这 里 不 会 详细 解释 所 有 的 FML 文 档 语 


一 个 是 install， 第 








法 ， 如 果 有 需要 ， 可 以 访问 http:/maven.apache.org/doxia/references/fm]- 


format.html. 


上 述 FML 文 档 展现 后 的 效果 如 图 15-17 所 示 。 





| Frequently Asked Questions 





Install 


1. Where to Download? 
2. How to Install? 


1. How to Run? 





Install 


Where to Download? 
Maven: http://maven.apache.org/download.html 


Nexus: http://nexus.sonatype.org/download-nexus.html 





How to Install? 


Description on the installation steps... 





| Run 
How to Run? 


Description on the installation steps... 





图 15-17 ”FML 文 档 效 果 





到 目前 为 上 ， 站 点 的 目录 结构 如 下 : 


-srce/ 
+ site/ 

+ resources/ 
| + images/ 
| + java. jpg 
| 
+ apt/ 
| + introduction. apt 
| 
+ fml/ 
| + £ql. fml 
| 


+ site. xml 


15.6 ”国际 化 


对 于 广大 欧美 以 外 的 用 户 来 说 ， 站 点 上 难免 需要 添加 一 些 本 土 的 文 
字 ， 如 果 没 有 特殊 的 配置 ， 站 点 可 能 无 法 对 其 使 用 正确 的 字符 集 编码 。 
本 节 以 简体 中 文 为 例 ， 介 绍 如 何 生 成 本 地 化 的 Maven 站 点 。 








要 生成 正确 的 简体 中 文 站 点 ， 用 户 首 先 需 要 确保 项 目 所 有 的 源码 ， 
包括 pom.xml、site.xml 以 及 apt 文 档 等 ， 都 以 UTF-8 编 码 保存 ， 各 种 编辑 
器 和 IDE 都 支持 用 户 指定 保存 文档 的 编码 。 图 15-18 就 展示 了 Windows 上 
用 记事 本 保存 文档 时 候 如 何 指定 UTF-8 编 码 。 


L „settings 


» src 
L main 
L site 





图 15-18 用 记事 本 保存 文档 时 指定 UTF-8 编 码 


接 下 来 要 做 的 是 告诉 maven-site-plugin 使 用 UTF-8 编 码 读 取 所 有 源码 
及 文档 ， 并 且 同 样 使 用 UTF-8 编 码 呈 现 站 点 html 文 档 。 这 两 点 可 以 通过 
配置 两 个 Maven 属 性 实现 ， 如 下 : 


<properties> 
<project. build. sourceEncoding >UTF-8 < /project. build. sourceEncoding > 


<project .reporting.outputEncoding >UTF-8 </project .reporting.outputEncoding > 
< /properties > 


project.build.sourceEncoding 属 性 用 来 指定 Maven 用 什么 编码 来 读 取 


源码 及 文档 ， 而 project.reporting.outputEncoding 用 来 指定 Maven 用 什么 编 
码 来 呈现 站 点 的 html 文 档 。 


最 后 一 步 要 做 的 是 配置 maven-site-plugin 指 定 当地 的 语言 ， 配 置 当 
地 语言 为 简体 中 文 zh_CN。 如 下 : 





<plugins > 


<plugin > 
<groupid >org. apache. maven. plugins < /groupId > 
<artifactIad >maven-site-plugin < /artifactId > 
<version >2.1.1< /version> 
< configuration > 
< locales > zh_CN < /locales > 
< /configuration > 
</plugin > 


<plugins > 


完成 这 些 配 置 后 ， 就 能 生成 图 15-19 所 示 的 中 文 站 点 。 





Account Captcha 


最 近 更 新 : 2010-07-27 | RE: 1.0.0-SNAPSHOT 








Account Captcha 团 队 

介绍 

使 用 一 个 成 功 的 项 目 要 求 许 多 人 扮演 许 条 的 角色 。 其 中 一 些 成 员 编写 代码 或 者 文档 ， 同 时 其 他 成 员 则 通过 列 试 、 打 补丁 以 及 

FAQ 捏 建议 等 方式 实现 自己 的 价值 。 
al 

6 1 一 个 团队 由 团队 成 员 以 及 贡献 者 组 成 。 团 队 成 员 直接 访问 项 目的 源 代码 并 积极 地 参与 编码 工作 。 贡 献 者 则 通过 向 成 员 提 d 

交 补 丁 和 提出 建议 来 完善 项 目 * 一 个 项 目 中 贡献 者 的 数量 是 不 限 的 。 请 立刻 加 入 到 贡献 行列 中 来 吧 。 素 心 感谢 所 有 对 项 了 

et 目 做 出 贡献 的 人 
项 目 文 站 
“而 目 入 息 

Dependency 成 = 


Management 

Plugin Management ae Be 3 aes 

Project Plugins 以 下 是 开发 者 的 列表 ， 他 们 有 提交 的 权限 ， 在 项 目 中 以 某 种 方式 直接 向 出 了 贡献 。 
持续 集成 
欢迎 来 到 
间 题 跟 路 juven Juven Xu juvenshun@gmail.com 一 8 Tue Jul 27 2010 17:55:38 GMT+0800 (China Standard Time) 
间 题 跟踪 
项 目 概要 
HER — 
项 目 团队 站 
RERA T L ` 
邮件 列表 本 项 目 没有 相关 贡献 者 。 请 以 后 再 查看 。 
BBE 

THERE 





图 15-19 ”生成 中 文 Maven 站 点 


15.7 Wawa 


为 了 方便 团队 和 用 户 得 到 必要 的 项 目 信 息 ， 我 们 需要 将 Maven 站 点 
部 晋 到 服务 堪 上 。Maven 文 持 多 种 协议 部 署 站 点 ， 包 括 FTP、SCP 和 
DAV。 





如 下 代码 就 配置 了 一 个 基于 DAV 协 议 的 站 点 部 普 地 址 : 


<project > 
<distributionManagement > 
<site> 
<id>app-site </id> 
<url >dav:https://www. juvenxu.com/sites/app < /url > 
</site> 


< /distributionManagement > 


/project > 


上 述 代 码 中 ，url 的 值 以 dav 开 头 ， 表 示 服 务 器 必须 文 持 WEBDAYV。 
此 外 ， 为 了 确保 安全 性 ， 服 务 器 的 访问 一 般 都 需要 认证 。 这 个 时 候 就 需 
要 配置 settings.xml 文 件 的 server 元 素 ， 这 一 点 与 部 区 构件 至 Maven 仓 库 类 
似 。 需 要 注意 的 是 : 要 确保 server 的 id 值 与 site 的 id 值 完全 一 致 。 





servers 
<server > 


<id>app-site </id> 
<username > juven < /user 
k k Re Ke </pa ER 


<password > 
/ server > 


< / servers > 


再 要 提醒 的 是 ， 如 果 在 部 普 的 时 候 遇 到 问题 ， 请 尝试 配置 最 新 的 


maven-site-plugin。 到 本 书 编写 时 为 止 ，2.x 的 最 新 版 本 为 2.1.1，3.x 的 最 


新 版 本 为 3.0-beta-2。 


如 果 想 要 使 用 FTP 协 议 部 署 站 点 ， 那 么 除了 配置 正确 的 部 署 地 址 和 


认证 信息 外 ， 还 需要 配置 额外 的 扩展 组 件 wagon-ftp， 如 代码 清单 15-13 


所 示 。 
代码 清单 15-13 ”使 用 FTP 协 议 部 署 站 点 


<plugins > 


<plugin > 


< gre OURT 


"Org.apache.maven.nplugins < /GroupIG > 
n-site-plugin < /artifactId> 


<arti ‘fac tid > > mav 
<version 24. ee rsion 
</plugin> 
< /plugins > 
<extensions > 
<extension > 
wagon < /groupid > 


< GroupIQGQ >org. apache. maven. wagon < 
artifactid >wagon-ftp < /artifactId> 


>1.0-beta-6 < /version > 





< f/extensions > 
< /build > 


<distributionManagement > 
<site> 
<id>app-site< /id> 
curl >ftp://www. juvenxu, com/site/app < /url > 
</S1Ce@> 


< /distributionManegement > 


< /project > 





述 代 码 中 最 重要 的 部 分 是 通过 extension 元 素 配 置 了 扩展 组 件 
wagon-ftp， 有 了 该 组 件 ，Maven 才 能 正确 识别 FTP 协 议 。 该 代码 中 为 
maven-site-plugin 和 wagon-ftp 都 配置 了 最 新 的 版 本 ， 这 么 做 是 为 了 避免 
之 前 版 本 中 存在 的 一 些 bug。 





如 果 和 希望 通过 SCP 协 议 部 署 站 点 ， 只 需要 相应 地 配置 
distributionManagement 元 素 即 可 。 如 下 : 


<project > 
<distributionManagement > 


<site> 
<id>app-site</id> 
<url >sep://shell. juvenxu. com/home/juven/maven/site/ < /url > 
Je i te > 


/distributionManagement > 


</ pod ed > 
与 DAV 和 FTP 不 同 的 是 ，SCP 协 议 通 常 使 用 密 钥 进行 认证 ， 因 此 在 


settings.xml 中 配置 认证 信息 的 时 候 ， 就 可 能 需要 passphrase 和 privateKey 
元 素 。 如 下 : 


server > 
<id>app-site</id> 


<passphra > some 


T 


Jassphrase < /passphrase > 
< priy ed >C:/sshkeys/id rsa< /privateKey > 
/ server > 


a> 


vi A ee EHEAR AUE SAC ECA R aA A Fma BELE 
Maven ği J: 


$ mvn clean site-deploy 


site-deploy 是 Site 和牛 命 周期 的 一 个 阶段 ， 其 对 应 绑 定 了 maven-site- 
plugin 的 deploy 目 标 ， 该 目标 的 工作 就 是 部 署 Maven 站 点 。 





15.8 ”小 结 


本 章 详细 讲述 了 如 何 使 用 Maven 生 成 项 目 站 点 ， 首 先 介绍 了 如 何 快 
速生 成 一 个 最 简单 的 站 点 ， 然 后 在 此 基础 上 通过 丰富 项 目 信息 来 丰富 站 
点 的 内 容 。 用 户 还 能 够 使 用 大 量 现成 的 插件 来 生成 各 种 站 点 报告 ， 包 括 
JavaDocs、 源 码 交 叉 引 用 、CheckStyle、PMD、ChangeLog 以 及 测试 履 


KIRE So 








此 外 ，Maven 还 允许 用 户 自 定义 站 点 各 个 部 分 的 外 观 ， 甚 至 更 换 皮 
肤 。 如 果 用 户 有 自 定 义 的 内 容 想 放 入 站 点 ， 则 可 以 编写 APT 或 者 FML 文 
档 。 


本 章 还 介绍 了 如 何 配置 POM 来 支持 中 文 的 站 点 。 最 后 ， 用 户 可 以 使 
用 WEBDAV、FTP 或 者 SCP 协 议 将 站 点 发 布 到 服务 器 。 


16% m2eclipse 


-m2eclipse fii JP 


新建 Maven 项 目 
.导入 Maven 项 目 
执行 mvn 命 令 
:访问 Maven 仓 库 
管理 项 目 依赖 
其 他 实用 功能 
小 结 


由 于 Eclipse 是 非常 流行 的 IDE， 为 了 方便 用 户 ， 日 常 开 发 使 用 的 各 
种 工具 都 会 提供 相应 的 Eclipse 插件 。 例 如 ，Eclipse 默 认 就 集成 了 JUnit 单 
元 测试 框架 、CVS 版 本 控制 工具 以 及 Mylyn 任 务 管理 框架 。Eclipse 插 件 
的 数量 非常 多 ， 读 者 可 以 访问 Eclipse Marketplacel!| 以 了 解 各 种 各 样 的 
Eclipse 插件 。m2eclipse 就 是 一 个 在 Eclipse 中 集成 Maven 的 插件 ， 有 了 该 


插件 ， 用 户 可 以 方便 地 在 Eclipse 中 执行 Maven 命 令 、 创 建 Maven 项 目 、 
修改 POM 文 件 等 。 本 章 将 详细 介绍 m2eclipse 的 使 用 。 


[1] 网 址 为 : http://marketplace.eclipse.org/。 


16.1 m2eclipse 简 介 


和 Nexus 一 样 ，m2eclipse 也 是 Sonatype 出 品 的 一 款 开源 工具 。 它 基 
于 Eclipse Public License-v.10 开 源 许 可 证 发 布 ， 用 户 可 以 免费 下 载 并 使 
用 ， 还 可 以 查看 其 源 代 码 。m2eclipse 的 官方 站 点 地 址 
为 http://m2eclipse.sonatype.org/。 


m2eclipse 为 Eclipse 环境 提供 了 全 面 丰富 的 Maven 集 成 。 它 的 主要 功 
能 如 下 : 


-创建 和 导入 Maven 项 目 

:管理 依赖 并 与 Eclipse 的 classpath 集 成 
-自动 下 载 依赖 

自动 解析 依赖 的 sources 与 javadoc 包 
.使 用 Maven Archetype 创 建 项 目 
-浏览 与 搜索 远程 Maven 仓 库 

“从 Maven POM 具 体 化 一 个 项 目 


.从 SCM 仓 库 签 出 Maven 项 目 





-自动 适 配 肉 和 套 的 多 模块 Maven 项 目 至 Eclipse 
.集成 Web Tools Projects (WTP ) 

.集成 Subclipse 

-集成 Mylyn 

.可视化 POM 编 辑 


图 形 化 依赖 分 析 


16.2 ”新 建 Maven 项 目 


m2eclipse 的 安装 已 经 在 2.5 节 中 详细 介绍 ， 这 里 不 再 痪 述 。 在 
m2eclipse 中 新 建 一 个 Maven 十 分 简单 ， 在 染 单 栏 中 依次 选择 
File New > Other， 这 时 可 以 看 到 图 16-1 所 示 的 同 导 。 


选择 Maven Project 之 后 ， 癌 导 会 提示 用 户 选 择 是 否 跳 过 archetype 而 
创建 一 个 最 简单 的 Maven 项 目 〈Create a simple project) 。 这 个 最 简单 项 
目 将 只 包含 最 基本 的 Maven 项 目 目录 结构 ， 读 者 可 以 根据 自己 的 需要 进 
行 选择 。 如 果 选 择 使 用 Archetype 创 建 项 目 ， 单 击 Next 按 钮 之 后 ， 疝 导 会 
提示 用 户 选 择 Archetype， 如 图 16-2 所 示 。 








Select a wizard 
Create a Maven Project 


Wizards: 


type filter text 


& General 
& cvs 
© Java 
© Maven 
EI, Checkout Maven Projects from SCM 


M3 Maven Module 
加 Maven POM file 
K Maven Project 

& SVN 

& Tasks 

E> XML 

(& Examples 


|© Ceea Cs) | | (cel 


图 16-1 新建 Maven 项 目 向 导 





© New Maven Project 


New Maven project 


Select an Archetype 





Nexus Indexer 
Group 1 Internal 

Default Local 
Drg.apacmereeecere ETET : f sapp etc 
org.apache.maven,archetypes maven-archetype-j2ee-simple RELEASE 
org.apache.maven,archetypes maven-archetype-marmalade-mojo RELEASE 
org.apache.maven.archetypes maven-archetype-mojo RELEASE 
org.apache.maven.archetypes maven-archetype-portlet RELEASE 


org.apache.maven.archetypes maven-archetype-profiles RELEASE 


z 








[7] Show the last version of Archetype only E] Include snapshot archetypes 


» Advanced 


< Back | Next > | 





图 16-2 ”选择 创建 项 目的 Archetype 


图 16-2 中 有 4 个 Archetype Catalog 可 供用 户 选 择 ， 包 括 maven- 
archetype-plugin 内 置 的 Internal、 本 地 仓库 的 Default Local, m2eclipse F 
载 到 仓库 索引 中 包含 的 Nexus Indexer， 以 及 所 有 这 3 个 合并 得 到 的 All 
Catalogs。 如果 对 Archetype Catalog 不 是 很 清楚 ， 可 以 参考 18.3 节 。 一 般 
来 说 ， 只 需要 选择 Internal， 然 后 再 选择 一 个 Archetype 〈 如 maven- 


archetype-quickstart) ， 最 后 单 击 Next 按 钮 。 


接 下 来 要 做 的 就 是 输入 项 目 坐 标 Group Id. Artifact Id4、Version 以 及 


包 名 。 这 一 个 步骤 与 在 命令 行 中 使 用 Archetype 创 建 项 目 类 似 ， 如 果 
Archetype 有 其 他 可 配置 的 属性 ， 用 户 也 可 以 在 这 里 一 并 配置 ， 如 图 16-3 
所 示 。 


® New Maven Project 


New Maven project 


Specify Archetype parameters 


Group Id; comjuvenxu 
Artifact Id: sample 

Version: 0.0,1-SNAPSHOT 
Package: com.juvenu.sample 


Properties available from archetype: 





Name Value 





> Advanced 





Finish | Cancel | 








图 16-3 ”为 项 目 输入 坐标 和 包 名 


单 击 Finish 按 钮 之 后 ，m2eclipse 就 会 快速 地 在 工作 区 创建 一 个 
Maven 项 目 ， 这 同时 也 是 一 个 Eclipse 项 目 。 


16.3. =A Maven™i H 





较 之 于 创建 新 的 Maven 项 目 ， 实 际 工作 中 更 常见 的 是 导入 现 有 的 
Maven 项 目 。m2edlipse 文 持 多 种 导入 的 方式 ， 其 中 最 常用 的 是 导入 本 地 
文件 系统 的 Maven 项 目 以 及 导入 SCM 仓 库 中 的 Maven 项 目 。 


单 击 沫 单 栏 中 的 File， 然 后 选择 Import 开 始 导入 项 目 ， 如 图 16-4 所 





从 图 16-4 中 可 以 看 到 在 Maven 类 中 有 4 种 导入 方式 ， 常 用 的 就 是 第 一 
种 和 第 二 种 ， 即 导入 SCM 仓 库 中 的 Maven 项 目 和 导入 本 地 文件 系统 的 


Maven 项 目 。 


图 16-4 中 的 Install or deploy an artifact to a Maven repository 能 让 用 户 
将 任意 的 文件 安装 到 Maven 的 本 地 仓库 。 如 果 该 文件 没有 对 应 的 POM， 


则 需要 为 其 定义 Maven 坐 标 。 


S import 





Select 


Import Existing Maven Projects 


Select an import source: 


type filter text 


© General 
i& CVS 
4 & Maven 
LI Check out Maven Projects from SCM 
LI Existing Maven Projects 
, Install or deploy an artifact to a Maven repository 
LI Materialize Maven Projects 
EE Run/Debug 
& SVN 
(= Tasks 





E Team 
(> XML 





Cancel 














图 16-4 ”开始 导入 Maven 项 目 


图 16-4 中 的 Materialize Maven Projects 能 让 用 户 导 入 第 三 方 的 Maven 
项 目 ， 用 户 只 需要 提供 一 些 关 键 字 如 nexus-api， 然 后 选择 要 导入 的 项 
目 ，m2eclipse 就 能 基于 索引 找到 其 对 应 的 POM 人 信息。 如 果 该 POM 中 包 
含 了 SCM 信 息 ，m2edlipse 就 能 直接 下 载 该 项 目的 源码 并 导入 到 
m2eclipse 中 。 当 用 到 某 个 第 三 方 类 库 ， 同 时 想 研究 其 源码 的 时 候 ， 这 一 
特性 就 非常 有 用 ， 你 不 再 需要 打开 浏览 器 去 寻找 该 项 目的 信息 ， 简 单 地 





在 m2eclipse 中 操作 几 步 就 能 完成 第 三 方 项 目的 导入 。 当 然 ， 这 一 特性 的 
前 提 是 第 三 方 类 库 提 供 了 正确 的 SCM 信 息 。 大 多 数 开 源 项 目 在 往 Maven 
中 央 仓 库 提 交 构 件 的 时 候 都 会 提供 完整 的 信息 ， 但 也 有 例外 ， 为 了 避免 
信息 不 完整 的 项 目 进 入 Maven 中 央 人 仓库， 最 新 的 规则 已 经 强制 要 求 提 交 
者 提供 完备 的 信息 ， 如 SCM、 许 可 证 以 及 源码 包 等 。 这 无 疑 能 帮助 


m2eclipse 表 现 得 更 好 。 








16.3.1 导入 本 地 Maven 项 目 


现在 详细 介绍 一 下 如 何 导 入 本 地 Maven 项 目 。 选 择 图 16-4 中 的 
Existing Maven Projects 项 ， 然 后 在 弹出 的 对 话 框 中 选择 本 地 项 目 所 在 的 
目录 ， 如 图 16-5 所 示 。 





m2eclipse 能 够 自动 识别 出 目录 中 所 包含 的 Maven 项 目 ， 如 果 发 现 是 
多 模块 项 目 ， 则 会 列 出 所 有 的 模块 。 用 户 可 以 根据 自己 的 需要 选择 要 导 
入 的 模块 ， 然 后 单 击 Finish 按 钮 。m2eclipse 会 执行 导入 项 目 信 息 、 更 新 
下 载 项 目 依赖 ， 以 及 重建 工作 区 等 操作 。 根 据 实际 项 目的 情况 ， 这 个 过 
程 可 能 花费 几 十 秒 到 十 几 分 钟 。 











© Import Maven projects 
Maven Projects 
Select Maven projects 


Root Directory: D:\git-juven\maven-book\code\ch-12 
Projects: 


4 |¥| /pom.xml - com.juvenxu.mynbook.accountiaccount-aggregator.L.0.0-SNAPSHOT:pom 
J] account-email/pom.aml - com.juvenxu.mynbook.eccounteccount-email:1.0,0-SNAPSHOT jar 
[F] account-persist/pom.xml - com,juvenxu.mynbook accountaccount-persist:L.0.0-SNAPSHOTijal| L 
account-parent/pom.xml - com.juvenxu.mvnbook.accountiaccount-parent:1.0.0-SNAPSHOT:pc 
account-captcha/pom.xml - comjuvenxu.mynbook.account:account-captcha:1.0.0-SNAPSHOT; 
闻 account-seryice/pom.xm! - com.juvenxu.mynbook.accountaccount-service:1.0.0-SNAPSHOT;ja 


网 account-web/pom.xml - comjuvenxu.mynbook.account:account-web:1.0.0-SNAPSHOT:wer 





[E] Add project(s) to working set 
Working set: [ 


» Advanced 














图 16-5 “导入 现 有 Maven 项 目 


16.3.2 ”从 SCM 仓 库 导 入 Maven 项 目 


通常 我 们 的 项 目 源 代码 都 存储 在 SCM 仓 库 中 ， 例 如 Subversion 仓 
库 ， 读 者 当然 可 以 使 用 Subversion 命 令 将 项 目 源 码 签 出 到 本 地 ， 然 后 再 
导入 到 m2eclipse 中 。 但 m2eclipse 文 持 用 户 直 接 从 SCM 仓 库 中 导入 Maven 


项 目 。 





要 从 SCM 导 入 Maven 项 目 ， 首 移 需 要 确保 安装 了 集成 SCM 的 Eclipse 
插件 ， 如 Subdlipse， 还 需要 m2eclipse 的 附属 组 件 Maven SCM Integration 
以 及 对 应 的 SCM handler， 如 集成 Subclipse 的 Maven SCM handler for 


Subclipse. 


如 果 这 些 组 件 都 得 以 正确 安装 ， 就 可 以 选择 图 16-4 中 的 Check out 
Maven Projects from SCM， 在 单 击 Next 按 钮 之 后 ， 选 择 SCM 类 型 并 输入 
SCM 地 址 ， 如 图 16-6 所 示 。 


@ Checkout as Maven project from SCM 


Target Location 


Select target location and revision 


SCM URL: | svn -| http://svn.apache.org/repos/asf/maven/archetype v Browse... 


[7] Check out Head Revision 


| | Select... 


区 Check out All projects 
» Advanced 





图 16-6 ”从 SCM 仓 库 导 入 Maven 项 目 


单 击 Next 按 钮 之 后 用 户 可 以 选择 项 目 导入 的 本 地 位 置 ， 然 后 单 击 
Finish 按 钮 ，m2eclipse 就 会 在 后 台 使 用 SCM 工 具 签 出 项 目 并 执行 Maven 
构建 。 用 户 可 以 单 击 Eclipse 右 下 角 的 状态 栏 查 看 后 台 进 程 的 状态 ， 如 图 
16-71 AN» 





Checking out Maven projects 


= E — 
Checking out /maven-compiler-plugin-2.3.1/o0m.x...urces\unit\compller-fail-test\ plugin-confia.xm! 





Checking out Maven projects: (17%) =- © 


图 16-7 m2edlipse 在 后 台 签 出 项 目 


同样 地 ， 根 据 项 目 大 小 以 及 网 络 的 健康 状况 ， 这 个 过 程 可 能 花费 几 
十 秒 到 几 十 分 钟 不 等 。 


16.3.3 ”m2eclipse 中 Maven 项 目的 结构 


一 个 典型 的 Maven 项 目 在 m2eclipse 中 的 结构 如 图 16-8 所 示 。 


age Explorer : fs Hierarchy| Ju JUnit] 
“> account-persist 
4 GS src/main/java 
b @ comjuvenxu.mvnbook.account.persist 
4 Œ src/main/resources 
\x) account-persist.xml 
4 CS src/test/java 
» Œ comjuvenxu.mvnbook.account.persist 
4 CE src/test/resources 
国 account-service.properties 
mi JRE System Library [/2SE-1.5] 
4 Š Maven Dependencies 
ga dom4j-1.6.1Ljar - D:\java\repository\dom4j\dom4j\1.6.1 
> a xml-apis-1.0.b2jar - D:\java\repository\xml-apis\xml-apis\1.0.b2 


ġa spring-core-2.5.6jar - D:\java\repository\org\springframework\spring-core\2.5.6 





> f@ commons-logging-1.1.1,jar - D:\java\repository\commons-logging\commons-logging\1.1.1 
ġa spring-beans-2.5.6.jar - D:\java\repository\\ 


p (8 aopalliance-1.0jar - D:\java\repository\aopalliance\aopalllance\L.0 
> dea junit-4.7,jar - D:\java\repository\junit\junit\4.7 
EE src 
E> target 
‘wl pom.xml 





4 | 








图 16-8 ”m2eclipse 中 的 Maven 项 目的 结构 


Maven 项 目的 主 代码 目录 src/main/java/、 主 资源 日 录 
src/main/resources/、 测 斌 代码 目录 src/test/java/ 和 测试 资源 目录 
src/test/resources/ 都 被 自动 转换 成 了 Eclipse 中 的 源码 文件 夹 〈《Source 


Folder) 。Maven 的 依赖 则 通过 Eclipse 库 (Libraries) 的 方式 引入 ， 所 有 
Maven 依 赖 都 在 一 个 名 为 Maven Dependencies 的 Eclipse 库 中 。 需 要 注意 
的 是 ， 这 些 依 赖 文件 并 没有 被 复制 到 Eclipse 工作 区 ， 它 们 只 是 对 Maven 
本 地 仓库 的 引用 。 所 有 的 源码 文件 夹 和 Maven 依 赖 都 在 Eclipse 项 目的 构 
建 路 径 〈Build Path) 中 。 当 然 ， 用 户 还 可 以 直接 访问 项 目 根 目 录 下 的 
pom.xml 文 件 。 此 外 ， 代 码 目 录 和 资源 目录 之 外 的 其 他 目录 不 会 被 转换 
成 Eclipse 的 源码 文件 夹 ， 它 们 不 会 被 加 入 到 构建 路 径 中 ， 但 用 户 还 是 可 
以 在 Eclipse 中 访问 它们 。 











注意 : 如 果 用 户 更 改 了 POM 内 容 且 守 致 项 目 结构 发 生变 化 ， 例 如 添 
加 了 一 个 额外 的 资源 目录 ，m2edlipse 可 能 无 法 自动 识别 。 这 时 用 户 需 要 
主动 让 m2edlipse 更 新 项 目 结构 : 在 项 目 或 者 pom.xml 上 单 击 鼠标 右键 ， 
选择 Maven， 再 选择 Update Project Configuration 。 


16.4 执行 mvn 命 令 








到 目前 为 止 ， 大 家 已 经 了 解 了 如 何在 m2eclipse 中 创建 Maven 项 目 和 
导入 Maven 项 目 ， 下 一 步 要 做 的 就 是 构建 这 些 项 目 ， 或 者 说 在 这 些 项 目 
中 执行 mvn 命 令 。 当 然 ， 大 家 还 是 可 以 在 命令 行 的 对 应 目录 下 执行 mvn 
命令 ， 不 过 这 里 要 讲 的 是 如 何在 m2eclipse 中 直接 执行 mvn 命 令 。 








要 在 m2eclipse 中 执行 mvn 命 令 ， 首 先 要 做 的 是 打开 m2edlipse 的 
Maven 控 制 台 。 一 般 来 说 ，Edlipse 窗 口 的 下 方 会 有 一 个 终端 (Console) 
视图 ， 打 开 该 视图 后 ， 可 以 在 视图 的 右上 角 选 择 打 开 Maven 终 问 ， 如 图 


16-9 所 示 o 





(©, Declarati | "$° Call Hier |4 Search |G Progres | É History El Console £3 


pst in D:/git-juven/maven-book/code/ch-: x “Bll vr 
1 Java Stack Trace Console 
2 New Console View 
3 SVN 控制 台 
=) 4CVS 
m2 5 Maven Console 








图 16-9 打开 Maven 终 端 


Maven 终 端 视 图 中 会 显示 m2edlipse 中 所 有 mvn 命 令 的 输出 。 现 在 可 
以 在 Maven 项 目 中 执行 mvn 命 令 。 直 接 在 项 目 上 或 者 pom.xml 上 单 击 鼠 标 
右键 ， 选 择 Run As 选项 ， 了 就 能 看 到 如 图 16-10 所 示 的 荣 单 。 


Paste Ctrl+V 
Delete Delete 


fron 


Build Path >| 


Alt+Shift+s » 
Alt+Shift+T » 


Source 
Refactor 


Import... 


y Export... 


Refresh 

Close Project 

Close Unrelated Projects 
Assign Working Sets... 


Run As 
Debug As 


1 Java Applet 


3 2 Java Application 


3 JUnit Test 
4 Maven assembly:assembly 


2 5 Maven build 


6 Maven build... 

7 Maven clean 

8 Maven generate-sources 
9 Maven install 

Maven package 


2 Maven sourceyjar 


Maven test 


Run Configurations... 


Alt+Shift+xX, A 
Alt+Shift+X, J 
Alt+Shift+X, T 


Alt+Shift+X, M 





图 16-10 ”执行 Maven 构 建 命令 


在 图 16-10 中 可 以 看 到 ， 采 单 预 置 了 很 多 构建 命令 ， 包 括 clean、 
test、package 以 及 install 等 ， 直 接 单 击 就 能 让 m2eclipse 执 行 相应 的 Maven 
构建 。 


如 果 想 要 执行 的 mvn 命 令 并 没有 被 预 置 在 这 个 荣 单 中 该 怎么 办 呢 ? 
这 时 可 以 选择 图 16-10 中 的 Maven build 项 来 自 定 义 mvn 命 令 。 图 16-11 显 
示 的 是 单 击 Maven Build... 项 后 显示 的 自 定 义 mvn 命 令 配 置 对 话 框 。 





Name: account-persist clean install 


ia Main BA JRE | 4A Refresh | 本 Environment 目 Common | 
Base directory: 





D:/git-juven/maven-book/code/ch-12/account-aggregator/account-persist 


| Browse Workspace... | | Browse File System... | | Variables.., | 








Goals: clean install | Select... | 


Profiles: 
“| Offline F] Update Snapshots 
-| Debug Output [Skip Tests {| Non-recursive 
~ | Resolve Workspace artifacts 








Fa Nene Value 





Maven Runtime: | External D:\bin\apache-maven-3.0-beta-1 (3.0-beta-1) 











| Apply 





a | 





图 16-11 自 定 义 mvn 命 令 


图 16-11 为 该 配置 提供 了 Maven 目 标 clean install， 还 定义 了 一 个 
account-persist clean install 的 名 称 以 方便 日 后 重用 。 读 者 可 以 看 到 该 配置 
页 面 能 让 用 户 自 定义 很 多 内 容 ， Re 否 跳 过 测 
试 、 是 否 开 启 Debug 输 出 ， 还 包括 添加 额外 的 运行 参数 ， 。 配 置 完 
成 后 ， 单 击 Run 按 钮 就 能 执行 该 mvn 命 令 了 。 读 者 可 以 在 Maven 终 端 查 
看 运行 输出 。 


使 用 上 述 的 方法 可 以 自 定 义 任意 多 的 mvn 命 令 ， 而 且 这 些 配 置 都 是 
可 以 被 重用 的 。 要 再 次 运行 自 定 义 的 mvn 命 令 ， 单 击 图 16-10 中 的 Maven 
build (注意 没有 省 略 写 ) ， 然 后 就 能 看 到 如 图 16-12 所 示 的 对 话 框 。 


= Select Configuration 


Select a launch configuration to run: 


m2 account-persist clean compile : clean compile 
m2 account-persist clean install : clean install 





m2 account-persist clean test : clean test 


a 





图 16-12 ”重用 目 定 义 mvn 命 令 


如 图 16-12 所 示 ， 读 者 可 以 选择 并 直接 运行 之 前 配置 过 的 自 定义 mvn 
命令 。 需 要 注意 的 是 ， 如 果 只 配置 了 一 个 自 定义 mvn 命 令 ，m2eclipse 会 
跳 过 该 选择 框 并 直接 运行 ， 如 果 还 没有 配置 任何 自 定 义 的 mvn 命 令 ， 
m2eclipse 则 会 提供 配置 对 话 框 让 读者 定义 (第 一 次 ) mvn 命 令 。 


16.5 ”访问 Maven 仓 库 


有 了 m2eclipse， 用 户 可 以 直接 在 Eclipse 中 浏览 本 地 和 远程 的 Maven 
仓库 ， 并 且 能 够 基于 这 些 仓库 的 索引 进行 构件 搜索 和 Java 类 搜索 。 这 样 
就 免 去 了 离开 Eclipse 访问 本 地 文件 系统 或 者 浏览 器 的 麻烦 ， 提 高 了 日 常 
开发 的 效率 。 





16.5.1 Maven 仓 库 视 网 


m2eclipse 提 供 了 Maven 仓 库 视 图 ， 能 让 用 户 方便 地 浏览 本 地 及 远程 
仓库 的 内 容 ， 不 过 默认 情况 下 该 视图 不 被 开启 。 要 开启 Maven 仓 库 视 
图 ， 依 次 选择 Eclipse 菜单 栏 中 的 Windows、Show View、Other 选 项 ， 
Eclipse 会 弹出 一 个 对 话 框 让 用 户 选择 要 打开 的 视图 。 选 择 Maven 类 下 的 


Maven Repositories， 如 图 16-13 所 示 。 





S Show View 


type filter text 


i= Maven Repositories 
= SVN 


Use F2 to display the description for a selected view. 


图 16-13 ”打开 Maven 仓 库 视 网 





这 时 可 以 在 Eclipse 窗口 下 方 看 到 Maven 仓 库 视 图 ， 这 个 视图 中 包含 
了 3 类 Maven 仓 库 ， 分 别 为 本 地 仓库 、 全 局 仓库 以 及 项 目 仓库 ， 如 图 16- 


14 所 示 。 


其 中 本 地 仓库 包含 了 Maven 的 本 地 仓库 以 及 当前 Eclipse 工作 区 的 项 
目 ， 全 局 仓库 默认 是 Maven 中 央 仓库 ， 但 是 如 果 在 settings.xml 中 设置 了 
镜像 ， 全 局 仓库 就 会 目 动 变更 为 镜像 仓库 。 最 后 ， 如 末 当 前 Maven 项 目 
的 pom.xml 中 配置 了 其 他 仓库 ， 它 们 就 会 被 自动 加 入 到 项 目 仓库 这 一 类 
中 。 这 些 仓 库 的 信息 来 源 于 用 户 的 settings.xml 文 件 和 工作 区 中 Maven 项 
目的 pom.xml 文 件 。 





[8 Problems | 多 Search |G Progress | É) History | Æ Console | 局 Maven Repositories £3 
If] t 
A Local Repositories 
H Local repository (D:\java\repository) 
局 Workspace projects 
|= Global Repositories 
H central (http://repo1.maven.org/maven2) 


= Project Repositories 








图 16-14 Maven 仓库 视图 





用 户 可 以 以 树 形 结构 快速 浏览 仓库 的 内 容 ， 双 击 叶 子 节 点 ， 打 开 构 
件 对 应 的 POM 文 件 ， 如 图 16-15 所 示 。 


4 R Local Repositories 
4 |= Local repository (D:\java\repository) 


4 [i protobuf-java - pom 


四 protobuf-java ; 2.0.3 
 commons-discovery 
E> javax 
E jmock 
4 (& junit 
|) junit - pom 


=> org 





图 16-15 ”浏览 Maven 仓 库 内 容 


大 家 可 能 已 经 猜 到 ，m2eclipse 其 实 不 会 真正 地 去 存储 所 有 仓库 的 内 
容 ， 那 样 需要 消耗 大 量 的 磁盘 及 网 络 融 宽 。 因 此 与 Nexus 一 样 ， 
m2eclipse 使 用 nexus-indexer 索 引 仓库 内 容 的 信息 。 以 全 局 仓库 central 为 
例 ， 用 户 在 首次 使 用 m2eclipse 的 仓库 浏览 及 搜索 功能 之 前 ， 需 要 构建 该 
仓库 的 索引 ， 在 如 图 16-16 所 示 的 仓库 上 右 击 。 








快捷 菜单 中 的 Rebuild Indexihm2eclipse 重 新 下 载 完整 的 远程 索引 ， 
由 于 当前 仓库 是 central， 索 引文 件 较 大 ， 因 此 重建 该 索引 会 消耗 比较 长 
的 时 间 。Update Index 则 让 m2eclipse 以 增 量 的 方式 下 载 索引 文件 。 如 果 
是 本 地 仓库 ，Update Index 将 无 法 使 用 ， 而 Rebuild Index hy iR E E 





历 本 地 仓库 的 文件 建立 索引 。 


图 16-16 中 的 菜单 还 有 几 个 选项 ，Disable Index Details 让 m2eclipse 关 
闭 该 仓库 的 索引 ， 从 而 用 户 将 无 法 浏览 该 仓库 的 内 容 ， 或 者 对 其 进行 搜 
Zo Minimum Index Enabled 表 示 只 对 仓库 内 容 的 坐标 进行 索引 ， 而 
Enable Full Index 不 仅 索 引 仓库 内 容 的 坐标 ， 还 索引 这 些 文件 所 包含 的 
Java 类 信息 ， 从 而 能 够 文 持 用 户 搜 索 仓库 中 的 Java 类 。 








= Global Repositories 
A central (http; 
4 (A Project Reposit¢ 


Copy URL 


GA apache nap a 
fal sOnatype-fol 
局 Custom reposit «= Update Index 


P Rebuild Index 


Materialize Projects 


% Disable Index Details 
‘|| Minimum Index Enabled 
ə Enable Full Index 


Collapse All 


30 Back 


Go Into 





图 16-16 RAKED FER | 


16.5.2 ”搜索 构件 和 Java 类 


有 了 仓库 索引 之 后 ， 用 户 就 可 以 通过 关键 字 搜索 Maven 构 件 了 。 单 
击 Eclipse 菜单 栏 中 的 Navigate， 再 选择 Open Maven POMM, WREE 
构件 搜索 框 。 输 入 关键 字 后 就 能 得 到 一 个 结果 列表 ， 还 可 以 点 击 列表 项 
进一步 展开 以 查看 版 本 信息 ， 如 图 16-17 所 示 。 双 击 某 个 具体 版 本 的 构 
件 能 让 m2edlipse 直 接 打开 对 应 的 POM 文 件 。 











® Search Maven POM 








Enter groupld, artifactid or shal prefix or pattern (*): 
ehcache 


Search Results: 





口 com.octo.captcha jcaptcha-extension-ehcache-store 
O ehcache ehcache 
B jpox jpox-ehcache 
A net.sf.ehcache ehcache 
4 日 netsfiehcache ehcache-core 
@, 2.1.0 - ehcache-core-2.1.0jar - 604K - Wed May 19 22:06:22 CST 2010 [http://repol.maven.org/maven2] 





i, 2,1,0-beta - ehcache-core-2,1.0-beta,jar - 591K - Tue Apr 20 21:35:46 CST 2010 [http://repol.maven 
i, 2.0.1 - ehcache-core-2.0.1.jar - 488K - Thu Apr 08 08:06:26 CST 2010 [http://repo1.maven.org/mave! 
i, 2.0.0 - ehcache-core-2.0.0,jar - 484K - Fri Mar 05 03:44:06 CST 2010 [http://repol.maven.org/maven ~ 


4 m b 

















E]include Javadocs [Include Sources 回 Incude Tests 


ehcache-core-2.1.0jar 618343 Wed May 19 22:06:22 CST 2010 


?) OK | Cancel 





图 16-17 搜索 Maven 构 件 





如 果 为 仓库 开启 T Enable Full Index 选 项 ， 也 就 是 说 索引 中 包含 了 


Java 类 型 信息 ， 则 就 可 以 通过 Java 类 名 的 关键 字 寻 找 构件 。 单 击 Eclipse 
菜单 栏 中 的 Navigate， 再 选择 Open Type from Maven， 就 能 得 到 类 搜索 
框 。 输 入 关键 字 后 就 能 得 到 图 16-18 所 示 的 搜索 结果 。 同 样 ， 用 户 可 以 
单 击 列表 项 展开 其 版 本 ， 还 可 以 双击 具体 版 本 打开 其 POM。 





® Search class in Maven repositories 


Enter groupld, artifactid or shal prefix or pattern (*): 
ehcache 


Search Results: 





EhCacheProvider org.hibernate.cache org.ow2.easybeans.osgi easybeans-core 
EhCacheRegionFactory net.sfiehcache.hibernate netsfiehcache ehcache-core 

EhCacheRegionFactory net.sfiehcache,hibernate org.ow2.orchestra orchestra-core 
EhCacheXAResourceHolder net.sf.ehcache.transaction.manager.btm netsf.ehcache ehcache-core 
EhCachexXAResourceProducer net.sfiehcache.transaction.manager.btm netsfehcache ehcache-core| | 
Ehcache netsfiehcache netsfehcache ehcache 

Ehcache net.sf.ehcache netsfehcache ehcache-core 

区 2.1.0 - ehcache-core-2.1.0,jar - 604K - Wed May 19 22:06:22 CST 2010 [http://repol.maven.org/mav 
|i, 2.1.0-beta - ehcache-core-2,1.0-beta jar - 591K - Tue Apr 20 21:35:46 CST 2010 [http://repol.maven 
[A 2.0.1 - ehcache-core-2.0.1.jar - 488K - Thu Apr 08 08:06:26 CST 2010 [http://repol.maven.org/mavel 
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加 
d) 
加 
J) 
ld 
而 
加 

















orchestra-core-4.4.2.bundle 6867992 Thu May 20 15:48:52 CST 2010 


@) 











图 16-18 ”搜索 Java 类 


不 用 离开 Eclipse， 用 户 就 能 随时 搜索 想 要 使 用 的 类 库 以 及 Java 类 ， 
m2ecjlipse 仅 仅 要 求 用 户 提供 一 些 必要 的 关键 字 ， 这 无 疑 是 非常 方便 的 。 


16.6 EH H KM 


添加 Maven 依 赖 的 传统 做 法 是 先 搜 索 得 到 依赖 的 坐标 ， 然 后 配置 项 
目的 pom.xml 文 件 ， 加 入 dependency 元 素 。 当 然 ， 在 m2eclipse 中 也 可 以 
这 样 做 ， 不 过 m2ecdlipse 提 供 了 更 方便 的 添加 依赖 的 方法 ， 用 户 直 接 根 据 
关键 字 搜 索 依赖 并 从 结果 中 选择 即 可 。 此 外 ，m2eclipse 还 提供 了 丰富 的 
可 视 化 界面 帮助 用 户 分 析 项 目 中 的 各 种 依赖 以 及 它们 之 间 的 关系 。 


16.6.1 添加 依赖 


在 m2eclipse 中 有 多 种 添加 依赖 的 方法 ， 和 直接 编辑 pom.xml 是 一 种 ， 
不 过 这 里 要 讲 的 是 为 外 两 种 更 方便 的 做 法 。 





首先 用 户 可 以 在 项 目 上 或 者 pom.xml 上 右 击 ， 然 后 选择 Maven， 再 
选择 Add Dependency 添 加 依赖 ， 如 图 16-19 所 示 。 


在 弹出 的 对 话 框 中 ， 用 户 只 需要 输入 必要 的 关键 字 ， 然 后 选择 要 添 
加 的 依赖 及 版 本 ， 并 且 设 定 正 确 的 依赖 范围 ， 单 击 OK 按 钮 之 后 ， 依 赖 
就 被 自动 加 入 到 pom.xml 中 。 图 16-20 所 示 就 为 项 目 添加 了 javax.servlet: 
servlet-api: 2.5 这 样 一 个 依赖 ， 并 且 在 图 的 下 方 选择 了 provided 这 样 一 个 
依赖 范围 。 


Copy Qualified Name 
Paste 
Delete 


Remove trom Context 
Build Path 

Source 

Refactor 


Import... 
Export... 


Refresh 

Close Project 

Close Unrelated Projects 
Assign Working Sets... 


Run As 
Debug As 
Validate 
Maven 
Team 


图 16-19 


Ctrl+V 
Delete 


Ctrl+Alt+Shift+Down 
> 
Alt+Shift+S » 
Alt+Shift+T » 








Add Dependency 
Add Plugin 
New Maven Module Project 


Update Dependencies 
Update Snapshots 

Update Project Configuration 
Download JavaDoc 
Download Sources 


Open POM 

Open Project Page 

Open Issue Tracker 

Open Source Control 

Open Continuous Integration 


Disable Workspace Resolution 
Disable Dependency Management 


Report Issue... 





在 项 目 上 添加 依赖 


@ Add Dependency 


Enter groupid, artifactid or shai prefix or pattern (*): 
servlet-api 


Search Results: 





G javax.servlet serviet-api 
四 2.5 - serviet-api-2.5.jar - 103K - Mon Jul 17 19:09:57 CST 2006 [http://repol.maven.org/maven2] 
2.4-20040521 - servlet-api-2.4-20040521.jar - 96K - Mon Aug 01 17:47:50 CST 2005 [http://repo1.mé a 
2.4.public_draft - serviet-api-2.4.public_draftjar - 95K - Mon Aug 01 17:53:48 CST 2005 [http://repol 
m 2.4 - serviet-api-2.4,jar - 95K - Mon Aug 01 17:53:27 CST 2005 (http://repol.maven.org/maven2] 
@, 2.3 - serviet-api-2.3jar - 76K - Sat Aug 13 08:02:58 CST 2005 [http://repol.maven.org/maven2] 
i, 2,2 - serviet-api-2.2,jar - 40K - Sat Aug 13 08:02:58 CST 2005 [http://repol.maven.org/maven2] 

D jetty serviet-api 

O org.apache.tomcat servlet-api 

4 m 

















同 Indude Javadocs [Include Sources |F]include Tests 


servlet-api-2.5.jar 105112 Mon Jul 17 19:09:57 CST 2006 


@ Scope: 


compile 
test 


runtime |F 
provided [xe 


system ~ 





图 16-20 ”为 项 目 添加 servlet-api 依 赖 


第 二 种 快速 添加 依赖 的 方式 是 使 用 m2eclipse 的 POM 编 辑 器 。 上 默认 
情况 下 ， 用 户 双击 项 目的 pom.xml 就 能 打开 POM 编 辑 器 。POM 编 译 右 下 
方 有 很 多 选项 卡 ， 包 括 概 览 、 依 赖 、 插 件 、 报 告 、 依 赖 层次 、 依 赖 图 、 
Effective POM 等 。 其 中 ， 依 赖 (Dependencies) 一 项 可 以 用 来 添加 、 删 
除 和 编辑 依赖 ， 如 图 16-21 所 示 。 


Im app/pom.xml. £3 


Dependencies Search: 


Dependencies TE Dependency Details 


Group Id:* junit 

Artifact id:* junit 

Version: 3.8.1 

Classifier; 

Type: 

Scope: test 

System Path: 
Dependency Management F] Optional 


Exclusions 





Overview Dependencies | Plugins | Reporting Dependency Hierarchy! Dependency Graph Effective POM | pom.xml 


图 16-21 _POM 编 辑 咒 中 的 依赖 管理 项 


单 击 图 16-21 中 上 方 的 Add 按 钮 束 能 得 到 如 图 16-20 所 示 的 添加 依赖 
对 话 框 。 此 外 ， 从 图 中 还 可 以 看 到 ， 用 户 可 以 但 看 依赖 的 细节 并 对 其 进 
行 编辑 。 


添加 项 目 依赖 之 后 ， 如 果 m2eclipse 没 有 自动 将 依赖 更 新 至 项 目的 构 
建 路 径 ， 用 户 可 以 强制 要 求 m2eclipse 更 新 ， 方 法 是 在 项 目 或 者 pom.xml 
上 右 击 ， 选 择 Maven， 再 选择 Update Dependencies. 





16.6.2 分 析 依 赖 


5.9.3 节 介绍 了 如 何 使 用 maven-dependency-plugin 分 析 并 优化 项 目的 
依赖 ，Maven 用 户 可 以 在 命令 行 以 树 状 的 形式 得 看 项 目的 依赖 以 及 它们 
之 间 的 关系 。 有 了 m2eclipse， 这 种 可 视 化 的 分 析 将 更 为 清晰 和 直观 。 


开启 POM 编 辑 器 中 的 依赖 层次 项 (Dependency Hierarchy) , tHE 
看 到 图 16-22 所 示 的 依赖 层次 图 。 








图 16-22 中 左边 列表 显示 了 项 目的 树 形 依赖 层次 ， 右 边 列 表 则 是 所 
有 Maven 最 终 解 析 得 到 的 依赖 。 默 认 情 况 下 ， 两 个 列表 都 会 显示 依赖 的 
artifact、version 以 及 scope。 要 得 看 依赖 的 groupId， 可 以 单 击 列表 上 方 
右 起 第 二 个 按钮 








Show Groupld。 


有 了 这 样 一 个 依赖 层次 图 ， 用 户 束 能 很 清晰 地 看 到 所 有 依赖 是 如 何 
进入 到 项 目 中 来 的 ， 可 能 这 是 个 直接 依赖 ， 那 么 在 左边 的 它 就 是 个 顶层 
节点 ; 可 能 这 是 个 传递 性 依赖 ， 那 么 这 个 树 形 层次 就 能 够 告诉 用 户 传递 
路 径 是 什么 。 如 果 这 个 依赖 是 同一 Maven 项 目的 男 外 一 个 模块 ， 那 么 它 
的 图 标 将 与 其 他 依赖 不 同 ， 而 是 一 个 文件 夹 的 样子 。 如 果 用 户 单 击 右边 
己 解 析 依 赖 列表 中 的 任意 一 项 ， 左 边 就 会 自动 更 新 为 该 依赖 的 传递 路 
径 ， 如 图 16-23 所 示 。 











Dependency Hierarchy [test] 


Dependency Hierarchy 


a © comicegreen : greenmall : 1.3.1b [test] count-captcha : 1.0.0-SNAPSHOT [compile] 
©) javax.mail : mail ; 1.4.1 (conflicted 1.4) [compile] (@ account-email : 1.0.0-SNAPSHOT [compile] 
© org.sifaj : slf4j-api : 1.3.1 [test] Æ account-persist : 1.0.0-SNAPSHOT [compile] 

D activation : 1.1 [compile] 

© aopalliance : 1.0 [compile] 

© commons-logging : 1.1.1 [compile] 

©) dom4j : 1.6.1 [compile] 

65 greenmail ; 1.3.1b [test] 


b  comjuvenxu.mvnbook.account : account-email ; 1.0.0-SNA 
4 |S comjuvenxu.mvnbook.account : account-persist : 1.0.0-SN 
a © dom4j : dom4j : 1.6.1 [compile] 
D xml-apis : xml-apis : 1.0.62 [compile] 
© org.springframework : spring-beans : 2.5.6 [compile] O junit = 47 [test] 
© org.springframework : spring-context : 2.5.6 [compile] Oi kaptcha : an - jdk15 [compile} 
B org.springframework : spring-core : 2.5.6 [compile] ©) mall : 14.1 comple} 
6 junit: junit ; 4.7 [test] n sifáj-api £23 fect 
© spring-beans : 2.5.6 [compile] 
O spring-context : 2.5.6 [compile] 
D spring-context-support : 2.5.6 [compile] 
© spring-core : 2.5.6 [compile] 
Ö xml-apis : 1.0.b2 [compile] 
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图 16-22 ”依赖 层次 列表 














Dependency Hierarchy [test] 


Search: x llv| 


+ 


Dependency Hierarchy = & | (jw $ Resolved Dependencies (TE) woo 闻 








| a B account- email : 1.0.0-SNAPSHOT [compile] kZ account-captcha : 1.0.0-SNAPSHOT [compile] 
46 mal: 1.4.1 [compile] (= account-email : 1.0.0-SNAPSHOT [compile] 
D activation : 1.1 [compile] , | Waccount-persist ; 1.0.0-SNAPSHOT [compile] 
Exclude Maven Artifact... D activation : 1.1 [compile] 
Open JavaDoc 目 aopalliance : 1.0 [compile] 
@ Open Project Page B commons-logging : 1.1.1 [compile] 
Open POM 5 ae 1.6.1 [compile] 


enmall : 1.3.15 [test 





©) junit: 4.7 [test] 

?| Ne : 2.3 - jdk15 [compile] 
©) mail : 1.4.1 [compile] 

© slf4j-api ; 1.3.1 [test] 

| 加 Spring- -beans ; 2.5.6 [compile] 

D spring-context : 2.5.6 [compile] 

D spring-context-support : 2.5.6 [compile] 
©) spring-core : 2.5.6 [compile] 

OD xml-apis ; 1.0.b2 [compile] 














4 m p 





- 
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图 16-23 ”查看 已 解析 依赖 的 传递 路 径 


从 图 16-23 中 我 们 知道 ，activation 这 样 一 个 依赖 是 通过 account-email 
依赖 的 mail 依 赖 引入 的 。 


此 外 ， 从 图 16-23 中 还 能 看 到 ， 在 任何 一 个 依赖 上 右 击 ， 可 以 执行 
打开 依赖 的 POM 和 排除 依赖 等 操作 。 尤 其 是 排除 依赖 这 一 操作 ， 比 编辑 
POM 更 加 直观 和 方便 。 


除了 依赖 层次 列表 ，POM 编 辑 器 还 提供 了 一 个 更 为 图 形 化 、 更 为 直 
观 的 依赖 图 ， 如 图 16-24 所 示 。 


在 这 个 依赖 图 中 ， 每 个 依赖 都 是 一 个 圆 角 和 矩形， 用户 可 以 随意 拖 动 
每 个 依赖 ， 被 选择 依赖 与 其 他 依赖 的 连接 线 会 被 标 亮 。 用 户 也 可 以 在 依 
赖 上 右 击 ， 选 择 显示 groupId， 以 及 执行 打开 POM 和 排除 依赖 等 操作 。 
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图 16-24 ”依赖 图 








16.7 其 他 实用 功能 


到 目前 为 止 ， 本 章 介 绍 了 m2edlipse 最 主要 的 几 个 功能 ， 包 括 新 建 项 
目 、 导 入 项 目 、 执 行 mvn 命 令 、 访 问 Maven 仓 库 和 管理 项 目 依 赖 。 
m2eclipse 还 有 很 多 琐碎 的 功能 ， 由 于 其 中 有 一 些 在 实际 中 很 少 用 到 ， 笔 
者 不 计划 逐一 详细 介绍 。 本 章 剩 余 的 内 容 讲述 几 个 m2eclipse 非 常 实 用 的 
小 特性 。 





16.7.1 POM 编 辑 的 代码 提示 


m2eclipse 的 POM 编 辑 器 能 让 用 户 以 表单 的 形式 编辑 pom.xml 文 件 ， 
但 很 多 时 候 这 总 没有 直接 编辑 XML 文件 来 得 直接 。 有 了 m2eclipse， 用 
户 在 编辑 pom.xml 的 时 候 就 能 得 到 即时 的 代码 提示 帮助 ， 如 图 16-25 所 











roupld>${project.groupid}</groupid 
tifactid>account-—email</artifactid 
ersion>$ {project .version}</vers 
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TEETE 
<groupId>com.icegreen</groupId> 
rtifa Id>greenmail</artifactid> 





ion>${greenmail.version}</version> 
scope>test</scope> 





图 16-25 POM 编辑 的 代码 提示 


在 图 16-25 中 可 以 看 到 ， 当 用 户 在 <dependency> 元 素 下 输入 左 尖 括 
号 想 要 添加 一 个 子 元 素 的 时 候 ， 会 得 到 可 用 元 素 的 列表 (用户 也 可 以 使 
用 Alt+/ 主 动 调 出 代码 提示 ) 。 在 该 例 中 ，<dependency> 下 可 用 的 子 元 素 
有 artifactId、classifier、exclusions 以 及 scope 等 。 使 用 键盘 的 上 下 键 可 以 














选择 查看 某 个 元 素 ， 列 表 右 边 就 会 显示 出 该 元 素 的 解释 。 该 例 中 右边 显 
示 了 scope 元 系 的 解释 。 选 择 想 要 输入 的 元 素 后 按 Enter 键 ，m2eclipse 了 就 
会 目 动 填 上 元 际 标 答 ， 用 户 只 需要 输入 元 象 的 值 即 可 。 对 于 不 熟悉 POM 
结构 的 用 户 来 说 ， 这 种 代码 提示 帮助 他 们 免 去 查阅 文档 的 麻烦 。 对 于 熟 
悉 POM 的 用 户 来 次 ， 代 码 提示 也 可 以 帮助 他 们 节省 输入 时 间 。 





16.7.2 Effective POM 


我 们 都 知道 ， 任 何 一 个 项 目的 POM 都 至 少 继承 自 Maven 内 置 的 超级 
POM， 有 些 项 目 中 用 户 还 会 配置 自己 的 继承 层次 。 也 就 是 说 ， 单 从 当前 
的 POM 是 无 法 全 面 了 解 项 目 信息 的 ， 你 必须 同时 查看 所 有 父 POM。 
Maven 有 一 个 Effective POM 的 概念 ， 它 表示 一 个 合并 整个 继承 结构 所 有 

言 息 的 POM。 假 设 项 目 A 继承 自 项 目 B， 而 B 勾 隐 式 地 继承 自 超 级 
POM, ABAAMEffective POM 就 包含 了 所 有 A、B 以 及 超级 POM 的 配 
置 。 有 了 Effective POM， 用 户 就 能 一 次 得 到 完整 的 POM 信 息 。 





Maven 用 户 可 以 直接 从 命令 行 获得 Effective POM: 
$ mvn help:effective -pom 


在 m2edlipse 的 POM 编 辑 器 中 ， 有 一 项 专门 的 Effective POM, FA 
可 以 直接 查看 当前 项 目的 Effective POM， 如 图 16-26 所 示 。 当 然 ， 由 于 
文 是 一 个 由 其 他 POM 合 并 而 来 的 文件 ， 你 将 无 法 对 其 直接 进行 修改 。 





<?xml version="1.0"?> 
<project xsi:schemaLocation="http: //maven.apache.org/POM/¢4.0.0 http://maven.apache.o 
xmins:xsi="http://vvv.w3.org/2001/XMLSchema—instance"> 
<modelVersion>4.0.0</modelVersion> 
<perent> 
<artifactid>account—parent</artifactid> 
<groupId>com. juvenxu.mvnbook.account</groupId> 
<version>1.0.0-SNAPSHOT</version> 
<relativePath>../account—parent/pom.xml</relativePath> 
</parent> 
<groupid>com. juvenxu.mvnbook.account</groupId> 
<artifactiId>account-persist</artifactid> 
<version>1.0.0—-SNAPSHOT</version> 
<name>Account Persist</name> 
<properties> 
<springframework.version>2.5.6</springframework.version> 
<dom4j3.version>1.6.1</dom4j.version> 
<junit.version>4.7</junit.version> 
</properties> 
<dependencyManagement> 
<dependencies> 
<dependency 
<groupId>org.springframework</groupId> 
<artifactid>spring-—core</artifactid> 
<version>2.5.6</version> 
</dependency 
eae 2CY> 


Dependency Graph | Effective POM | pom.xml 
图 16-26 Effective POM 





16.7.3 ”下载 依赖 源码 


m2eclipse 能 够 自动 下 载 并 使 用 依赖 的 源码 包 ， 当 你 需要 探 完 第 三 方 
开源 依赖 的 细节 ， 或 者 在 调试 应 用 程序 的 时 候 ， 这 一 特性 非常 有 用 。 当 
然 ， 该 功能 的 前 提 是 依赖 提交 了 相应 的 源码 包 至 Maven 仓 库 ， 通 常 这 个 
源码 包 是 一 个 classifier 为 sources 的 jar 文 件 。 例 如 junit-4.8.1.jar 就 有 一 个 对 
应 的 junit-4.8.1-sources.jar 源 码 包 。 





m2eclipse 用 户 可 以 在 项 目 上 或 者 pom.xml 上 右 击 ， 选 择 Maven， 表 
选择 Download Sources 让 m2eclipse 为 当前 项 目的 依赖 下 载 源码 包 。 也 可 
以 设置 Maven 首 选项 让 m2eclipse 默 认 自动 下 载 源 码 包 。 方 法 是 单 击 
Eclipse 菜单 中 的 Window 并 选择 Preferences， 然 后 在 弹出 的 对 话 框 左边 选 
择 Maven， 接 着 在 右边 选 上 Download Artifact Sources， 如 图 16-27 所 示 。 
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图 16-27 开启 源码 包 下 载 


从 图 16-27 中 读者 还 可 以 看 到 ，Maven 首 选项 允许 配置 很 多 m2eclipse 
的 默认 行为 ， 包 括 是 人 否 开 局 Debug 输 出 、 是 否 打开 Edlipse 就 下 载 索 引 
等 。 左 边 的 Maven 子 项 还 允许 用 户 做 更 多 的 配置 ， 包 括 配置 m2eclipse 使 
用 的 Maven 安 装 、 自 定义 settings.xml 文 件 等 。 读 者 可 以 根据 自己 的 实际 
需要 进行 调整 ， 这 里 不 再 玖 述 。 





16.8 ”小 结 


笔者 不 推荐 在 不 熟悉 Maven 谷 ji annie 
不 理解 Maven 的 基本 概念 和 命令 行 操 作 ， 华 丽 的 IDE 界 面 只 能 给 你 市 来 
更 多 的 困惑 ， 尤 其 是 当 遇 到 问题 的 时 候 ， 由 于 牵扯 了 更 多 的 非 Maven 因 
素 ， 排 疑 会 变 得 更 加 困难 。 


如 果 你 已 经 熟悉 了 Maven 的 基本 概念 和 命令 行 ， 并 且 你 日 常 使 用 的 
IDE 是 Eclipse， 那 么 就 大 胆 使 用 m2eclipse 吧 。 你 可 以 在 m2eclipse 中 直接 
创建 Maven 项 目 ， 也 可 以 从 本 地 或 者 SCM 仓 库 导 入 Maven 项 目 ， 在 
m2eclipse 中 执行 mvn 命 令 也 很 方便 ， 你 还 可 以 自 定义 并 保存 mvn 命 令 。 
m2eclipse 还 集成 了 Maven 仓 库 客户 端的 功能 ， 不 用 离开 IDE， 用 户 就 可 
以 浏览 和 搜索 Maven 仓 库 ， 并 且 随 时 添加 依赖 。m2edlipse 提 供 的 依赖 分 
析 功 能 也 比 命令 行 更 加 直观 和 清晰 。 除 了 这 些 主要 特性 ，m2eclipse 还 能 
让 用 户 享受 便捷 的 POM 编 辑 代 码 提 示 ， 可 以 直接 得 看 Effective POM, 
以 及 自动 下 载 使 用 依赖 的 源码 包 ， 这 些 功能 都 能 大 大 提高 日 常 开发 的 效 








第 17 章 ”编写 Maven 搬 件 


-编写 Maven 插 件 的 一 般 步 又 

案例: 编写 一 个 用 于 代码 行 统计 的 Maven 插 件 
.Mojo 标 注 

.Mojo 参 数 

-错误 处 理 和 日 志 

测试 Maven 插 件 

小 结 


本 书 第 7 章 已 经 讲 过 ，Maven 的 任何 行为 都 是 由 插件 完成 的 ， 包 括 
项 目的 清理 、 纺 译 、 测 试 以 及 打包 等 操作 都 有 其 对 应 的 Maven 插 件 。 
个 插件 拥有 一 个 或 者 多 个 目标 ， 用 户 可 以 直接 从 命令 行 运行 这 些 插件 目 
标 ， 或 者 选择 将 目标 绑 定 到 Maven 的 生命 周期 。 





大 量 的 Maven 插 件 可 以 从 AapchelJ 和 Codehausl2 获 得 ， 这 里 的 近 百 
个 插件 几乎 能 够 满足 所 有 Maven 项 目的 需要 。 除 此 之 外 ， 还 有 很 多 


Maven 插 件 分 布 在 Googlecode、Sourceforge、Github 等 项 目 托管 服务 

中 。 因 此 ， 当 你 发 现 自己 有 特殊 需要 的 时 候 ， 首 先 应 该 搜索 一 下 看 是 否 
已 经 有 现成 的 播 件 可 供 使 用 。 例 如 ， 如 果 想 要 配置 Maven 自 动 为 所 有 
Java 文 件 的 头 部 添加 许可 证 声明 ， 那 么 可 以 通过 关键 字 maven plugin 
license 找 到 maven-license-pluginl3l， 这 个 托管 在 Googlecode 上 的 项 目 完全 
能 够 满足 我 的 需求 。 











在 一 些 非常 情况 下 《几率 低 于 1%) ， 你 有 非常 特殊 的 需求 ， 并 且 
无 法 找到 现成 的 插件 可 供 使 用 ， 那 么 就 只 能 自己 编写 Maven 插 件 了 。 编 
写 Maven 插 件 并 不 是 特别 复杂 ， 本 章 将 详细 介绍 如 何 一 步 步 编写 能 够 满 
足 目 己 需 要 的 Maven 插 件 。 





[1] 网址 为 : http://maven.apache.org/plugins/index.html。 
[2] 网 址 为 : http://mojo.codehaus.org/plugins.html。 


[3] 网 址 为 : http://code.google.com/p/maven-license-plugin/。 


17.1 编写 Maven 插 件 的 一 般 步 又 
为 了 能 让 读者 对 编写 Maven 插 件 的 方法 和 过 程 有 一 个 总 体 的 认识 ， 
下 面 先 简要 介绍 一 下 编写 Maven 插 件 的 主要 步骤 。 


1) 创建 一 个 maven-plugin 项 目 : 插件 本 映 也 是 Maven 项 目 ， 特 殊 的 
地 方 在 于 它 的 packaging 必 须 是 maven-plugin， 用 户 可 以 使 用 maven- 
archetype-plugin 快 速 创建 一 个 Maven 插 件 项 目 。 








2) 为 插件 编写 目标 : 每 个 插件 都 必须 包含 一 个 或 者 多 个 目标 ， 
Maven 称 之 为 Mojo〈 与 POJO 对 应 ， 后 者 指 Plain Old Java Object， 这 里 指 
Maven Old Java Object) 。 编 写 插件 的 时 候 必 须 提 供 一 个 或 者 多 个 继承 


自 AbstractMojo 的 类 。 





3) 为 目标 提供 配置 点 : 大 部 分 Maven 插 件 及 其 目标 都 是 可 配置 
的 ， 因 此 在 编写 Mojo 的 时 候 需 要 注意 提供 可 配置 的 参数 。 








4) 编写 代码 实现 目标 行为 : 根据 实际 的 需要 实现 Mojo。 





5) 错误 处 理 及 日 志 : 当 Mojo 发 生 异 常 时 ， 根 据 情况 控制 Maven 的 
运行 状态 。 在 代码 中 编写 必要 的 日 志 以 便 为 用 户 提供 足够 的 信息 。 


6) 测试 插件 ， 编写 目 动 化 的 测试 代码 测试 行为 ， 然 后 再 实际 运行 
插件 以 验证 其 行为 。 


17.2 pil: 编写 一 个 用 于 代码 行 统计 的 Maven 插 
件 








为 了 便于 大 家 实践 ， 下 面 将 详细 演示 如 何 实际 编写 一 个 简单 的 用 于 
代码 行 统计 的 Maven 插 件 。 使 用 该 插件 ， 用 户 可 以 了 解 到 Maven 项 目 中 
各 个 源 代 码 目录 下 文件 的 数量 ， 以 及 它们 加 起 来 共有 多 少 代码 行 。 不 
过 ， 笔 者 强烈 反对 使 用 代码 行 来 考核 程序 员 ， 因 为 大 家 都 知道 ， 代 码 的 
数量 并 不 能 真正 反映 一 个 程序 员 的 价值 。 





要 创建 一 个 Maven 插 件 项 目 ， 首 先 使 用 maven-archetype-plugin 命 


S$ mvn archetype:generate 
然后 选择 : 
maven-archetype-plugin (An archetype which contains a sample Maven plugin. ) 


输入 Maven 坐 标 等 信息 之 后 ， 一 个 Maven 插 件 项 目 就 创建 好 了 。 打 
开 项 目的 pom.xml 可 以 看 到 如 代码 清单 17-1 所 示 的 内 容 。 


代码 清单 17-1 ”代码 行 统计 插件 的 POM 


<project xmlns = "http://maven.apache.org/POM/4.0.0" 


xmlns:xsi = "http://Www.w3 .org/2001 /XMLSchema — instance" 





xsi:schemaLocation = "http://maven.apache.org/POM/4.0.0 
http://maven. apache. org/maven -v4.0 0.xsd"> 


<modelVersion >4.0.0 < /modelVersion > 





com. juvenxu.mvnbook < /groupId > 
<artifactId >maven —loc —plugin < /artifactId> 
<packaging >maven -plugin < /packaging > 


<version >0.0.1—-—SNAPSHOT < /version > 


<name >Maven LOC Plugin < /name > 
<url >http://www. juvenxu. com/ < /ur 


<properties > 
<maven. version >3.0 < /maven. version > 
< /properties > 
< dependencies > 
< dependency > 
<groupid >org. apache. maven < /groupId > 
<artifactId >maven —plugin —api < /artifactId > 
<version> $ {maven. version} < /version > 
< /dependency > 
< /dependencies > 
< /project > 


Maven 插 件 项 目的 POM 有 两 个 特殊 的 地 方 : 


1) 它 的 packaging 必 须 为 maven-plugin， 这 种 特殊 的 打包 类 型 能 控制 
Maven 为 其 在 生命 周期 阶段 绑 定 插件 处 理 相关 的 目标 ， 例 如 在 compile 阶 
段 ，Maven 需 要 为 插件 项 目 构建 一 个 特殊 插件 擅 述 符 文 件 。 


2) 从 上 述 代 码 中 可 以 看 到 一 个 artifactId 为 maven-plugin-api 的 依 
赖 ， 该 依赖 中 包含 了 插件 开发 所 必需 的 类 ， 例 如 稍 后 会 看 到 的 
AbstractMojo。 需 要 注意 的 是 ， 代 码 清单 17-1 中 并 没有 使 用 默认 
Archetype 生 成 的 maven-plugin-api 版 本 ， 而 是 升级 到 了 3.0， 这 样 做 的 目 
的 是 与 Maven 的 版 本 保持 一 致 。 


插件 项 目 创建 好 之 后 ， 下 一 步 是 为 插件 编写 目标 。 使 用 Archetype 生 
成 的 插件 项 目 包 含 了 一 个 名 为 MyMojo 的 Java 文 件 ， 我 们 将 其 删除 ， 然 
后 自己 创建 一 个 CountMojo， 如 代码 清单 17-2 所 示 。 


代码 清单 17-2 ”CountMojo 的 主要 代码 


Pai % 
s Goal which counts lines of code of a project 
x 
+ @ goal count 
=/ 
public class CountMojo 
extends AbstractMojo 
{ 


private static final String[{] INCLUDES DEFAULT = { "java"; "xml", "properties" 


/** 
+ @ parameter expression =" $ {project.basedir}" 
+ @ required 
+ @ readonly 
=/ 
private File basedir; 


few 
+ @ parameter expression =" $ {project. build. sourceDirectory}" 
+ @ required 
+ @ readonly 
=/ 
private File sourceDirectory; 


Ste hp 
+ @ parameter expression =" $ {project. build. testSourceDirectory }" 
* @ required 
* @ readonly 
*/ 
private File testSourceDirectory; 


/** 
+ @ parameter expression =" $ {project. build. resources }" 
* @ required 
* @ readonly 
a/ 
private List <Resource > resources; 


jw 
* @ parameter expression =" $ {project. build. testResources}" 
* @ required 
* @ readonly 
a / 
private List <Resource > testResources; 


pe 


* The file types which will be included for counting 
w 
* @ parameter 
E 4 
private String[] includes; 


public void execute () 


throws MojoExecut ionException 


if (includes = = null || includes- length == 0) 
{ 

includes = INCLUDES_DEFAULT; 
try 


countDir( sourceDirect ory ); 
countDir({ testSourceDirectory ); 
) 


for ( Resource resource : resources 


countDir ( new File( resource. getDirectory () ) ) 


} 


for ( Resource resource : testResources ) 
{ 
{ 
countDir (new File( resource. getDirectory() ) ); 
1 
i 


} 
catch ( IOExceptione ) 
E 
i 
throw new MojoExecutionException( "Unable to count lines of code. ", e ); 


} 


首先 ， 每 个 插件 目标 类 ， 或 者 说 Mojo， 都 必须 继承 AbstractMojo 并 
实现 execute O 方法 ， 只 有 这 样 Maven 才 能 识别 该 插件 目标 ， 并 执行 
execute O 方法 中 的 行为 。 其 次 ， 由 于 历史 原因 ， 上 述 CountMojo 类 使 
H T Java 1.4 风 格 的 标注 (将 标注 写 在 注释 中 ) ， 这 里 要 关注 的 是 
@goal， 任 何 一 个 Mojo 都 必须 使 用 该 标注 写 明 自己 的 目标 名 称 ， 有 了 目 
标定 义 之 后 ， 我 们 才能 在 项 目 中 配置 该 插件 目标 ， 或 者 在 命令 行 调用 


Zo PIU: 


$ mvn com. juvenxu.mvnbook :maven-loc-plugin:0.0.1-SNAPSHOT:count 








iE —“S Mojo 4 A TERES: 继承 AbstractMojo、 实 现 
execute () 方法 、 提 供 @goal 标 注 。 


下 一 步 是 为 插件 提供 配置 点 。 我 们 希望 该 插件 默认 统计 所 有 Java、 
XML， 以 及 properties 文 件 ， 但 是 允许 用 户 配置 包含 哪些 类 型 的 文件 。 
代码 清单 17-2 中 的 includes 字 段 就 是 用 来 为 用 户 提供 该 配置 点 的 ， 它 的 类 
型 为 String 数 组 ， 并 且 使 用 了 @parameter 人 参数 表示 用 户 可 以 在 使 用 该 插 
件 的 时 候 在 POM 中 配置 该 字段 ， 如 代码 清单 17-3 所 示 。 














代码 清单 17-3 ”配置 CountMojo 的 includes 参 数 


<plugin > 
<groupId >com. juvenxu.mvnbook < /groupId > 
<artifactId >maven -loc -plugin < /artifactId > 


version >0.0.1 — SNAPSHOT < /version > 


< include >sql < 


< /includes > 





onfiguration > 


< /executions > 


代码 清单 17-3 配 置 了 CountMojo 统 计 Java 和 SQL 文件 ， 而 不 是 默认 的 
Java、XML 和 Properties 。 


代码 清单 17-2 中 还 包含 了 basedir、sourceDirectory、 


testSourceDirectory 等 字段 ， 它 们 都 使 用 了 @parameter 标 注 ， 但 同时 关键 
字 expression 表 示 从 系统 属性 读 取 这 几 个 字段 的 值 。 $ {project.basedir}、 
$ {project.build.sourceDirectory}. $ {project.build.testSourceDirectory} 等 
AIA DEA MZ OAAES, CIDIR SA Sea ERB H 
录 和 测试 代码 目录 。G@readonly 标 注 表 示 不 允许 用 户 对 其 进行 配置 ， 
为 对 于 一 个 项 目 来 说 ， 这 几 个 目录 位 置 都 是 固定 的 。 











了 解 这 些 简 单 的 配置 点 之 后 ， 下 一 步 就 该 实现 插件 的 具体 行为 了 。 
从 代码 清单 17-2 的 execute〈) 方法 中 大 家 能 看 到 这 样 一 些 信息 : 如 果 用 
户 没 有 配置 includes 则 就 是 用 默认 的 统计 包含 配置 ， 然 后 再 分 别 统计 项 
目 主 代码 目录 、 测 试 代码 目录 、 主 资源 目录 ， 以 及 测试 资源 目录 。 这 里 
涉及 一 个 countDir() 方法 ， 其 具体 实现 如 代码 清单 17-4 所 示 。 








代码 清单 17-4 ”CountMojo 的 具体 行为 实现 


private void countDir( File dir ) 
throws IOException 


if ( !dir.exists() ) 


for (File sourceFile : collected ) 
{ 
lines + = countLine( sourceFile ); 


} 


String path = dir.qetAbsolutePath ().substring ( basedir.getAbsolutePath () 
- length () ); 


getLog (). info{ path + ":" + lines + "lines of code in" + collected.size() + 
"files" ); 


} 
private void collectFiles( List <File> collected, File file ) 


{ 
if ( file.isFile() ) 


$ 
for ( String include : includes ) 
{ 
if ( file. getName().endsWith( *." + include ) ) 
{ 
collected. add{ file ); 
break; 
} 
} 
} 
else 
{ 
for {File sub : file. listFiles() ) 
{ 
collectFiles( collected, sub }; 
} 
} 


} 


private int countLine( File file ) 
throws IOException 
{ 
BufferedReader reader = new BufferedReader ( new FileReader( file ) ); 


int line = 0; 
try 


{ 
while { reader. ready () ) 


{ 
reader, readLine(); 
line + +; 
} 
} 
finally 
{ 


reader.close(); 


这 里 简单 解释 一 下 上 述 三 个 方法 : collectFiles〈) 方法 用 来 递归 地 
收集 一 个 目录 下 所 有 应 当 被 统计 的 文件 ，countLine () 方法 用 来 统计 单 
个 文件 的 行 数 ， 而 countDir O 则 借助 上 述 两 个 方法 统计 茶 一 目录 下 共 
有 多 少 文 件 被 统计 ， 以 及 这 些 文件 共 包 含 了 多 少 代 码 行 





代码 清单 17-2 中 的 execute〈) 方法 包含 了 简单 的 异常 处 理 ， 代 码 行 
统计 的 时 候 由 于 涉及 了 文件 操作 ， 因 此 可 能 会 抛 出 IOException。 当 捕获 
到 IOException 的 时 候 ， 使 用 MojoExecutationException 对 其 简单 包装 后 再 
抛 出 ，Maven 执 行 插件 目标 的 时 候 如 果 遇 到 MojoExecutationException， 
就 会 在 命令 行 显示 “BUILD ERROR” 信 息 。 


代码 清单 17-4 中 的 countDir O 方法 的 最 后 一 行使 用 了 AbstractMojo 
的 getLog〈) 方法 ， 该 方法 返回 一 个 类 似 于 Log4j 的 日 志 对 象 ， 可 以 用 
来 将 输出 日 志 到 Maven 命 令 行 。 这 里 使 用 了 info 级 别 的 日 志 告 诉 用 户 某 
个 路 径 下 有 多 少 文件 被 统计 ， 共 包含 了 多 少 代 码 行 ， 因 此 在 使 用 该 插件 
的 时 候 可 以 看 到 如 下 的 Maven 输 出 : 


[INFO] ---maven —loc —plugin:0.0.1—SNAPSHOT:count (default) @ app -—-- 
INFO) src main \java: 13 lines of code in 1 files 
[INFO] src test \java: 38 lines of code inl files 


使 用 mvn clean install 命 令 将 该 插件 项 目 构建 并 安装 到 本 地 仓库 后 ， 


就 能 使 用 它 统计 Maven 项 目的 代码 行 了 。 如 下 所 未: 


$ mvn com. juvenxu.mvnbook :maven — loc - plugin:0.0.1—-—SNAPSHOT:count 

[INFO] Scanning for projects... 

[INFO 

[INFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
INFO] Building Account Captcha 1.0.0 - SNAPSHOT 
TREE 
[INFO] 

[INFO] —--maven-loc —plugin:0.0.1-SNAPSHOT:count (default-cli) @ account-cap- 
tcha --- 

[INFO] \srce\main\java: 179 lines of code in 4 files 

[INFO] \sre\test \java: 112 lines of code in2 files 

INFO] \sre \main\resources: 11 lines of code in 1 files 

[INFO] \src \test \resources: 0 lines of code inO files 





(NRO) se ee ee ee ee ee 
[INFO] BUILD SUCCESS 

[INFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Total time: 0.423s 

[INFO] Finished at: Sat Jun 05 16:28:35 CST 2010 

[INFO] Final Memory: 1M/4M 


[ENEO ee ee 


如 采 嫌 命令 行 太 长 太 复杂 ， 可 以 将 该 插件 的 groupId 添 加 到 
settings.xml 中 。 如 下 所 示 : 


<settings > 
<pluginGroups > 
<pluginGroup > Com. juvenxu. mvnbook < /pluginGroup > 


< /pluginGroups > 
< /settings > 


现在 Maven 命 令 行 就 可 以 简化 成 : 


$ mvn loc:count 





这 里 面 的 具体 原理 可 参考 7.8.4 节 。 


17.3 “Mojo 标 注 


每 个 Mojo 都 必须 使 用 @Goal 标 注 来 注 明 其 目标 名 称 ， 人 否则 Maven 将 
无 法 识别 该 目标 。Mojo 的 标注 不 仅 限 于 @Goal， 以 下 是 一 些 可 以 用 来 控 
制 Mojo 行 为 的 标注 。 





‘@goal<name> 


这 是 唯一 必须 声明 的 标注 ， 当 用 户 使 用 命令 行 调用 插件 ， 或 者 在 
POM 中 配置 插件 的 时 候 ， 都 需要 使 用 该 目标 名 称 。 


-@phase<phase> 


默认 将 该 目标 绑 定 至 Default 生 命 周 期 的 某 个 阶段 ， 这 样 在 配置 使 用 
该 插件 目标 的 时 候 束 不 需要 声明 phase。 例 如 ，maven-surefire-plugin 的 


test 目 标 就 带 有 @phase test 标 注 。 
-@requiresDependencyResolution<scope> 


表示 在 运行 该 Mojo 之 前 必须 解析 所 有 指定 范围 的 依赖 。 例 如 ， 
maven-surefire-plugin 的 test 目 标 带 有 @requiresDependencyResolution test 
标注 ， 表 示 在 执行 测试 之 前 ， 所 有 测试 范围 的 依赖 必须 得 到 解析 。 这 里 
可 用 的 依赖 范围 有 compile、test 和 runtime， 默 认 值 为 runtime。 


(OrequiresProject<true/false> 





表示 该 目标 是 否 必须 在 一 个 Maven 项 目 中 运行 ， 默 认为 tue。 大 部 
分 插件 目标 都 需要 依赖 一 个 项 目 才能 执行 ， 但 有 一 些 例 外 。 例 如 maven- 
help-plugin 的 System 目标 ， 它 用 来 显示 系统 属性 和 环境 变量 信息 ， 不 需 
要 实际 项 目 ， 因 此 使 用 了 @requiresProject false 标 注 。 另 外 ，maven- 
archetype-plugin 的 generate 目 标 也 是 一 个 很 好 的 例子 。 





-@requiresDirectInvocation<true/false> 





当 值 为 true 的 时 候 ， 该 目标 就 只 能 通过 命令 行 直接 调用 ， 如 果 试 图 
在 POM 中 将 其 绑 定 到 生命 周期 阶段 ，Maven 束 会 报错 ， 默 认 值 为 false。 
如 果 你 希望 编写 的 插件 只 能 在 命令 行 独立 运行 ， 就 应 当 使 用 该 标注 。 


-@requiresOnline<true/false> 


表示 是 个 要 求 Maven 必 须 是 在 线 状 态 ， 默 认 值 是 false。 


(OrequiresReport<true/false> 


表示 是 否 要 求 项 目 报告 已 经 生成 ， 默 认 值 是 false。 





‘@aggregator 





当 Mojo 在 多 模块 项 目 上 运行 时 ， 使 用 该 标注 表示 该 目标 只 会 在 顶层 


模块 运行 。 例 如 maven-javadoc-plugin 的 aggregator-jar 使 用 了 @aggregator 


标注 ， 它 不 会 为 多 模块 项 目的 每 个 模块 生成 Javadoc， 而 是 在 顶层 项 目 
生成 一 个 已 经 聚合 的 Javadoc 文 档 。 


‘(Dexecute goal=“<goal>” 





在 运行 该 目标 之 前 先 让 Maven 运 行 另外 一 个 目标 ， 如 果 是 本 插件 的 
目标 ， 则 直接 使 用 目标 名 称 ， 人 否则 使 用 "prefix: goa” HÉR, BEH H 
标 前 级 。 例 如 ，maven-pmd-plugin 是 一 个 使 用 PMD 来 分 析 项 目 源码 的 工 
具 ， 它 包含 pmd 和 check 等 目标 ， 其 中 pmd 用 来 生成 报告 ， 而 check 用 来 
验证 报告 。 由 于 check 是 依赖 于 pmd 生 成 的 内 容 的 ， 因 此 可 以 看 到 它 使 用 
了 标注 @execute goal=“pmd”. 


‘(Dexecute phase=“<phase>” 





在 运行 该 目标 之 前 让 Maven 先 运行 一 个 并 行 的 生命 周期 ， 到 指定 的 
阶段 为 止 。 例 如 maven-dependency-plugin 的 analyze 使 用 了 标注 @execute 
phase="test-compile"， 因 此 当 用 户 在 命令 行 执行 dependency: analyze 的 
时 候 ，Maven 会 首先 执行 default 生 命 周 期 所 有 至 test-compile 的 阶段 。 


‘@execute lifecycle=“<lifecycle>”phase=“<phase>” 





在 运行 该 目标 之 前 让 Maven 先 运行 一 个 自 定 义 的 生命 周期 ， 到 指定 
的 阶段 为 止 。 例 如 maven-surefire-report-plugin 这 个 用 来 生成 测试 报告 的 
插件 ， 它 有 一 个 report 目 标 ， 标 注 了 @execute 





phase='"test"lifecycle="surefire"， 表 示 运 行 这 个 自 定 义 的 surefire 声 明 周 期 
至 test 阶 段 。 自 定义 生命 周期 的 配置 文件 位 于 src/main/resources/META- 
INF/maven/lifecycle.xml。 内 容 如 代码 清单 17-5 所 示 。 


代码 清单 17-5 ”maven-surefire-report-plugin 的 自 定义 生命 周期 


id st </ic 
<conf pe ration > 

tFailureIgnore >true < /testFailureIgnore > 
< a iguration > 


</ phas e> 





17.4 “Mojo 参 数 


正如 在 代码 清单 17-2 中 所 看 到 的 那样 ， 我 们 可 以 使 用 @parameter 将 
Mojo 的 某 个 字段 标注 为 可 配置 的 参数 ， 即 Mojo 参数。 事实 上 几乎 每 个 
Mojo 都 有 一 个 或 者 多 个 Mojo 参 数 ， 通 过 配置 这 些 参数 ，Maven 用 户 可 以 
自 定义 插件 的 行为 。7.5.2 节 和 7.5.3 节 就 分 别 配 置 了 maven-compiler- 





plugin 和 maven-antrun-plugin 的 Mojo 参 数 。 


Maven 文 持 种 类 多 样 的 Mojo 参 数 ， 包 括 单 值 的 boolean、int、float、 
String、Date、File 和 URL， 多 值 的 数组 、Collection、Map、Properties 


等 。 


:boolean (包括 boolean 和 Boolean) 


/* * 


à @ parameter 
rivate boolean sampleBoolean 
对 应 的 配置 如 下 : 
<sampleBoolean >true < /sampleBoolean > 


‘int (@44Integer. long. Long. short. Short. byte, Byte) 


Pi a 


* @ parameter 
| / 


private int sampleInt 
对 应 的 配置 如 下 : 

<sampleInt >8 < /sampleInt > 
‘float (@444Float. double. Double) 


j 
Y 3 
fs & 


* @ parameter 
更 


private float sampleFloat 


对 应 的 配置 如 下 : 


<sampleFloat >8.8< /sampleFloat > 


‘String (包括 StringBuffer、char、Character) 


/ * * 


+ @ parameter 


*/ 


private String sampleString 
对 应 的 配置 如 下 : 


<sampleString >Hello World < /sampleString > 


‘Date (格式 为 yyyy-MM-dd HH: mm: ss.S a 或 者 yyyy-MM-dd 


HH: mm: ssa) 


PE SB 

* @ parameter 

«x / 

private Date sampleDate 


对 应 的 配置 如 下 : 

<sampleDate >2010 -06 -06 3:14:55.1 PM< /sampleDate > 
或 者 

<sampleDate >2010 -06 -06 3:14:55PM < /sampleDate > 
‘File 


/ xx 

* @ parameter 

x / 

private File sampleFile 


对 应 的 配置 如 下 : 


<sampleFile>c:\tmp < /sampleFile > 


‘URL 


PAE tg 

* @ parameter 

*/ 

private URL sampleURL 


对 应 的 配置 如 下 : 


< sample =URL >http://www. juvenxu. com/ < /sampleURL > 


数组 


MX 


* @ parameter 
*/ 


private String[] includes 
对 应 的 配置 如 下 : 


<includes> 


< include > java < /include > 


< include >sal < /include > 
< /includes > 


‘Collection 〈 任 何 实现 Collection 接 口 的 类 ， 如 ArrayList 和 HashSet ) 


[x * 


* @ parameter 
* / 
private List includes 


对 应 的 配置 如 下 : 


<includes > 


< include > java < /include > 


< include >sal < /include > 
< /includes > 


‘Map 


/* * 

* @ parameter 

*/ 

private Map sampleMap 


对 应 的 配置 如 下 : 


<sampleMap > 
<keyl >valuel < /key2 > 
<keyl >value2 < /key2 > 
< /sampleMap > 


-Properties 


pe 

* @ parameter 

* / 

private Properties sampleProperties 


对 应 的 配置 如 下 : 


<sampleProperties > 
<property > 
<name >p_name_i < /name > 
<value >p_value_l < /value > 
< /property > 
<property > 
<name >p_name_2 < /name > 
<value >p_value_2 < /value > 
< / property > 
< /sampleProperties > 


一 个 简单 的 @parameter 标 注 就 能 让 用 户 配置 各 种 类 型 的 Mojo 字 段 ， 
不 过 在 此 基础 上 ， 用 户 还 能 为 @parameter 标 注 提供 一 些 额 外 的 属性 ， 进 
一 步 自 定义 Mojo 参 数 。 


-@parameter alias=“<aliasName>” 
使 用 alias， 用 户 就 可 以 为 Mojo 参 数 使 用 别名 ， 当 Mojo 字 段 名 称 太 长 
或 者 可 读 性 不 强 时 ， 这 个 别名 就 非常 有 用 。 例 如 : 


fe * 
* @ parameter alias = "uid" 


private String uniquelIdentity 


对 应 的 配置 如 下 : 


-@parameter expression=“${aSystemProperty}” 





使 用 系统 属性 表达 式 对 Mojo 参 数 进行 赋值 ， 这 是 非常 有 用 的 特性 。 
配置 了 @parameter 的 expression 之 后 ， 用 户 可 以 在 命令 行 配 置 该 Mojo 参 
数 。 例 如 ，maven-surefire-plugin 的 test 目 标 有 如 下 源码 : 





用 户 可 以 在 POM 中 配置 skip 参 数 ， 同 时 也 可 以 直接 在 命令 行使 用 - 
Dmaven.test.skip=true 来 跳 过 测试 。 如 果 Mojo 参 数 没有 提供 expression,， 
那 就 意味 着 该 参数 无 法 在 命令 行 直接 配置 。 还 需要 注意 的 是 ，Mojo 参 数 
的 名 称 和 expression 名 称 不 一 定 相同 。 


‘@parameter default-value=“aValue/${anExpression }” 


如 果 用 户 没 有 配置 该 Mojo 参 数 ， 就 为 其 提供 一 个 默认 值 。 该 值 可 以 
是 一 个 简单 字面 量 如 “true” “hello” 或 者 “1.5”， 也 可 以 是 一 个 表达 式 ， 
以 方便 使 用 POM 的 某 个 元 素 。 


例如 ， 下 面 代码 中 的 参数 sampleBoolean 默 认 值 为 true: 


/ + * 
* @ parameter defaultValue ="true" 
ADA 


private boolean sampleBoolean 


代码 清单 17-2 中 有 如 下 代码 : 


/天 * 

* @ parameter expression =" $ {project. build. sourceDirectory}" 
* @ required 

* @ readonly 


P 
= / 


private File sourceDirectory; 
表示 默认 使 用 POM 元 素 <project><build><sourceDirectory> 的 值 。 


除了 @parameter 标 注 外 ， 还 看 到 可 以 为 Mojo 参 数 使 用 @readonly 和 
@required 标 注 。 


-@readonly 


RAN YMojoF Be ABA, WRH SZENE, ALP MIER HE 


行 配置 。 通 常 在 应 用 POM 元 素 内 容 的 时 候 ， 我 们 不 希望 用 户 干 涉 。 代 码 
清单 17-2 就 是 很 好 的 例子 。 


-@readonly 


该 Mojo 参 数 且 其 没有 默认 值 ，Maven 就 会 报错 。 


17.5 ”错误 处 理 和 日 志 


如 果 大 家 看 一 下 Maven 的 源码 ， 会 有 发 现 AbstractMojo 实 现 了 Mojo 接 
口 ，execute〈) 方法 正 是 在 这 个 接口 中 定义 的 。 具 体 代 码 如 下 : 


void execute () 
throws MojoExecutionException, MojoFailureException; 


这 个 方法 可 以 抛 出 两 种 异常 ， 分 别 是 MojoExecutionException 和 


MojoFailureException. 


如 果 Maven 执 行 插件 目标 的 时 候 遇 到 MojoFailureException， 就 会 显 
示 “BUILD FAILURE” 的 错误 信息 ， 这 种 异常 表示 Mojo 在 运行 时 发 现 了 
预期 的 错误 。 例 如 maven-surefire-plugin 运 行 后 肴 发 现 有 失败 的 测试 就 会 
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如 果 Maven 执 行 插件 目标 的 时 候 遇 到 MojoExecutationException， 就 
会 显示 “BUILD ERROR” 的 错误 信息 。 这 种 异常 表示 Mojo 在 运行 时 发 现 
了 未 预期 的 错误 ， 例 如 代码 清单 17-2 中 我 们 不 知道 代码 行 统计 插件 何 时 
会 过 到 IOException， 这 个 时 候 只 能 将 其 舱 套 进 MojoExecutationException 
后 再 抛 出 。 








上 述 两 种 异常 能 够 在 Mojo 执 行 出 错 的 时 候 提 供 一 定 的 信息 ， 但 这 往 
往 是 不 够 的 ， 用 户 在 编写 插件 的 时 候 还 应 该 提供 足够 的 日 志 信 息 ， 


AbstractMojo 提 供 了 一 个 getLog O 方法 ， 用 户 可 以 使 用 该 方法 获得 一 
个 Log 对 象 。 该 对象 文 持 四 种 级 别 的 日 志方 法 ， 它 们 从 低 到 高 分 别 为 : 


‘debug: 调试 级 别 的 日 志 。Maven 默 认 不 会 输出 该 级 别 的 日 志 ， 
过 用 户 可 以 在 执行 mvn 命 令 的 时 候 使 用 -X 参 数 开 局 调试 日 志 ， 该 级 别 的 
日 志 古 用 来 帮助 程序 员 了 解 插件 具体 运行 状态 的 ， 因 此 应 该 尽量 详细 。 
需要 注意 的 是 ， 不 要 指望 你 的 用 户 会 主动 去 看 该 级 别 的 日 志 。 





‘info: 消息 级 别 的 日 志 。Maven 默 认 会 输出 该 级 别 的 日 志 ， 该 级 别 
的 日 志 应 该 足够 简洁 ， 帮 助 用 户 了 解 插件 重要 的 运行 状态 。 例 如 ， 
maven-compiler-plugin 会 使 用 该 级 别 的 日 志 告 诉 用 户 源 代码 编译 的 目标 
目录 。 





warn: 敬告 级 别 的 日 志 。 妆 插件 运行 的 时 候 过 到 了 一 些 问题 或 错 
误 ， 不 过 这 类 问题 不 会 导致 运行 失败 的 时 候 ， 就 应 该 使 用 该 级 别 的 日 志 
警告 用 户 尽 快 修复 。 





‘error: 错误 级 别 的 日 志 。 当 插件 运行 的 时 候 遇 到 了 一 些 问题 或 错 
误 ， 并 且 这 类 问题 导致 Mojo 无 法 继续 和 运行， 就 应 该 使 用 该 级 别 的 日 志 提 
供 详细 的 错误 信息 


上 述 每 个 级 别 的 日 志 都 提供 了 三 个 方法 。 以 debug 为 例 ， 它 们 分 别 


‘void debug (CharSequence content) ; 


‘void debug (CharSequence content, Throwable error) ; 


-void debug (Throwable error) ; 





用 户 在 编写 插件 的 时 候 ， 应 该 根据 实际 情况 选择 适应 的 方法 。 基 本 
的 原则 是 ， 如 果 腊 常 出 现 ， 束 应 该 尽量 使 用 适宜 的 日 志方 法 将 异常 堆 
栈 记录 下 来 ， 方 便 将 来 的 问题 分 析 。 


如 果 使 用 过 Log4j 之 类 的 日 志 框架 ， 束 应 该 不 会 对 Maven 日 志文 持 感 
到 陌生 ， 日 志 不 是 一 个 Maven 插 件 的 核心 代码 ， 但 是 为 了 方便 使 用 和 调 
试 ， 完 整 的 插件 应 该 具备 足够 丰富 的 日 志 代 码 。 


17.6 测试 Maven 插 件 





编写 Maven 插 件 的 最 后 一 步 是 对 其 进行 测试 ， 单 元 测试 较 之 于 一 般 
的 Maven 项 目 无 异 ， 可 以 参考 第 10 半 。 手 动 测 试 Maven 插 件 也 是 一 种 做 
法 ， 读 者 可 以 将 插件 安装 到 本 地 仓库 后 ， 再 找 个 项 目测 试 该 插件 。 本 市 
要 介绍 的 并 非 上 述 两 种 读者 已 经 十 分 熟悉 的 测试 方法 ， 而 是 如 何 编写 自 
动 化 的 集成 测试 代码 来 验证 Maven 插 件 的 行为 。 








读者 可 以 想象 一 下 ， 既 然 是 集成 测试 ， 那 么 束 一 定 需 要 一 个 实际 的 
Maven 项 目 ， 配 置 该 项 目 使 用 插件 ， 然 后 在 该 项 日 上 运行 Maven 构 建 ， 
最 后 再 验证 该 构建 成 功 与 否 ， 可 能 还 需要 检查 构建 的 输出 。 








既然 有 数 以 千 计 的 Maven 插 件 ， 那 么 很 可 能 已 经 有 很 多 人 过 到 过 上 
述 的 需求 ， 因 此 Maven 社 区 有 一 个 用 来 帮助 插件 集成 测试 的 插件 ， 它 就 
是 maven-invoker-plugin。 该 插件 能 够 用 来 在 一 组 项 目 上 执行 Maven， 并 
检查 每 个 项 目的 构建 是 否 成 功 ， 最 后 ， 它 还 可 以 执行 BeanShell 或 者 
Groovy 脚 本 来 验证 项 目 构 建 的 输出 。 


BeanShell 和 Groovy 都 是 基于 JVM 平 台 的 脚本 语言 ， 读 者 可 以 访问 
http://www.beanshell.org/ 和 http://groovy.codehaus.org/ 以 了 解 更 多 的 信 
尽 。 本 章 下 面 的 内 容 会 用 到 少许 的 Groovy 代 码 ， 不 过 这 些 代码 十 分 简 
单 ， 很 容易 理解 。 


回顾 一 下 前 面 的 代码 行 统计 插件 ， 可 以 使 用 Archetype 创 建 一 个 最 简 
单 的 Maven 项 目 ， 然 后 在 该 项 目 中 配置 maven-loc-plugin。 如 果 一 切 正 
常 ， 就 应 该 能 够 看 到 如 下 的 Maven 构 建 输出 : 


[INFO] \src\main\java: 13 lines of code in 1 files 


NFO] \sre\test \java: 38 lines of code in 1 files 


为 了 验证 这 一 行为 ， 先 配置 maven-loc-plugin 的 POM 使 用 maven- 
invoker-plugin， 如 代码 清单 17-6 所 示 。 


代码 清单 17-6 ”配置 maven-loc-plugin 使 用 maven-invoker-plugin 


<plugin> 
<groupld >org. apache. maven. plugins < /groupId > 
<artifactId >maven-invoker-plugin < /artifactId> 
<version >1.5< /version > 
<configuration > 


<projectsDirectory >src/it < /projectsDirectory > 


>install < /goal > 





tBuildHookScript >validate. groovy < /postBuildHookScript > 
/configuration > 





<executions > 
< execution > 
<id>integration-test < /id> 
<goals > 
<goal >install < /goal > 
<goal >run</goal > 
</goals > 
< /execution > 
/ executions > 


< /plugin > 


代码 清单 17-6 中 maven-invoker-plugin 有 三 项 配置 。 首 先 
projectDirectory 用 来 配置 测试 项 目的 目录 ， 也 就 是 说 在 srcit 目 录 下 存放 
要 测试 的 Maven 项 目 源 码 ; 其 次 goals 表 示 在 测试 项 目 上 要 运行 的 Maven 


目标 ， 这 里 的 配置 就 表示 maven-invoker-plugin 会 在 src/it 目 录 下 的 各 个 
Maven 项 目 中 运行 mvn install 命 令 ; 最 后 的 postBuildHookScript 表 示 在 测 


试 完成 后 要 运行 的 验证 脚本 ， 这 里 是 一 个 groovy 文 件 。 


从 代码 清单 17-6 中 我 们 还 看 到 ，maven-invoker-plugin 的 两 个 目标 
install 和 run 被 绑 定 到 了 integration-test 生 命 周 期 阶段 。 这 里 的 install 目 标 
用 来 将 当前 的 插件 构建 并 安装 到 仓库 中 供 测试 项 目 使 用 ，run 目 标 则 会 
执行 定义 好 的 mvn 命 令 并 运行 验证 脚本 。 





当然 仅仅 该 配置 还 不 够 ，src/it 目 录 下 必须 有 一 个 或 者 多 个 供 测 试 的 
Maven 项 目 ， 我 们 可 以 使 用 maven-archetype-quickstart 创 建 一 个 项 目 并 修 
改 POM 使 用 mvn-loc-plugin， 如 代码 清单 17-7 所 示 。 该 测试 项 目的 其 余 
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代码 清单 17-7 ”maven-loc-plugin 的 测试 项 目 POM 


<project xmlns = "http://maven. apache. org/POM/4.0.0" 
xmins:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xsi:schemaLocation = "http: //maven. apache. org/POM/4.0.0 
http://maven. apache. org /maven-v4_0_0.xsd" > 
<modelVersion >4.0.0 < /modelVersion > 
<groupId >com. juvenxu < /groupId > 
<artifactId >app < /artifactId> 
< packaging > jar < /packaging > 
<version >1.0-SNAPSHOT < /version > 
<name >app < /name > 
<url >http://maven. apache. org < /url > 
< dependencies > 
< dependency > 
<groupid >junit </groupid> 
<artifactIid>junit < /artifactId > 
<version >3.8.1 < /version > 
< scope >test < /scope > 
< /dependency > 
< /dependencies > 
<build> 
<plugins > 
<plugin> 
<groupiId > Com. juvenxu.mvnbook < /groupId > 
<artifactId >maven-loc-plugin < /artifactId> 
<version >0.0.1 -SNAPSHOT < /version > 
<executions > 
<execution > 
<goals > 
< goal >count < /goal > 
< /goals > 
<phase >verify < /phase > 
< f/execution > 
< / executions > 
< /plugin > 
< /plugins > 
< /build > 
< /project > 


代码 清单 17-7 就 是 一 个 最 简单 的 POM， 然 后 配置 maven-loc-plugin 的 
count 目 标 绑 定 到 了 verify 生 命 周期 阶段 。 





测试 项 目 准 备 好 了 ， 现 在 要 准备 的 是 与 该 项 目 对 应 的 验证 脚本 文 
件 ， 即 validate.groovy， 它 应 该 位 于 srciVyapp 目 录 下 《〈 即 上 述 测试 项 目的 
RAS) ， 内 容 如 代码 清单 17-8 所 示 。 


代码 清单 17-8 maven-loc-plugin 的 集成 测试 验证 脚本 


def file new File (basedir, 'build.1og') 


def countMain = false 
def countTest false 


file.eachLine { 
if (it = ~ /srce.main. java: 13 lines of code in1 files/) 


countMain = true 
if (it =~ /sre.test. java: 38 lines of code in1 files/) 
countTest = true 


if ( !countMain ) 


throw new RuntimeException( “incorrect src/main/java count info" ); 
if ( !countTest ) 
throw new RuntimeException( “incorrect src/test/java count info" ); 





这 段 Groovy 代 码 做 的 事情 很 简单 。 它 首先 读 取 app 项 目 目录 下 的 
build.log 文 件 ， 当 maven-invoker-plugin 构 建 测试 项 目的 时 候 ， 会 把 mvn 
输出 保存 到 项 目下 的 build.log 文 件 中 。 因 此 ， 可 以 解析 该 日 志文 件 来 验 
证 maven-loc-plugin 是 否 输出 了 正确 的 代码 行 信息 。 





上 述 Groovy 代 码 首 先 假设 没有 找到 正确 的 主 代码 统计 信息 和 测试 代 
码 统计 信息 ， 然 后 它 逐 行 明 有 历 日 志文 件 ， 紧 接着 使 用 正则 表达 式 检查 寻 
找 要 检查 的 内 容 《〈《 两 个 料 杠 /中 间 的 内 容 是 正则 表达 式 ， 而 =~ 表 示 寻 找 
该 正则 表达 式 匹 配 的 内 容 ) ， 如 果 找 到 期 望 的 输出 ， 残 将 countMain 和 
countTest 置 为 ue。 最 后 ， 如 末 这 两 个 变量 的 值 有 false， 束 抛 出 对 应 的 


异常 信息 。 


Maven 会 首先 在 测试 项 目 app 上 运行 mvn install 命 令 ， 如 果 运 行 成 


功 ， 则 再 执行 validate.groovy 脚 本 。 只 有 脚本 运行 通过 日 没 有 异常 ， 集 
成 测试 才 算 成 功 。 





现在 在 maven-loc-plugin 下 运行 mvn clean install， 就 能 看 到 如 下 的 输 


[INFO] ---maven - invoker-plugin:1.5:install (integration-test) @ maven-loc- 
plugin -—-- 

[INFO] Installing D: \ws-maven-book ee ee \pom. xn ni to D: \java\ \reposi 一 
tory \ com \ juvenxu \ mvnbook \ maven- loc- plugin \0.0.1-SNAPSHOT \ maven- loc- plugin- 
0.0.1-SNAPSHOT. pom 

[INFO pata ling D: \ws-maven-book \maven-loc-plugin \target \maven-loc-plugin- 
0.0.1-SNAPSHOT. jar to D: \ java \ repository \com \ juvenxu \mvnbook \maven-loc-plugin \ 
0.0.1-SNAPS SHOT \maveri-loe-plugin-0 .0.1-SNAPSHOT. jar 

NFO 

[INFO] ---maven-invoker-plugi ‘1.5 江 un (integration-test) @ maven-loc-plugin ——— 

[WARNING] Filtering of parent/c chil i POMs is not supported without cloning the pro- 
Jects 

[INFO] Building: app \ in xml 

INFO] ..SUCCESS (3.4 5 
INFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 





INFO} Build Summary: 


[INFO] Passed: 1, Failed: 0, Errors: 0, Skipped: 0 


INEO] cenen a ERRES 


从 输出 中 可 以 看 到 maven-invoker-plugin 的 install 目标 将 当前 项 目 
maven-loc-plugin 安 装 至 本 地 仓库 ， 然 后 它 的 run 目 标 构建 测试 项 目 app， 


并 最 后 报告 运行 结 
至 此 ， 所 有 Maven 插 件 集 成 测试 的 步骤 就 都 完成 了 。 


上 述 样 例 只 涉及 了 maven-invoker-plugin 的 很 少 一 部 分 配置 点 ， 用 户 
还 可 以 配置 : 


‘debug (boolean) : 是 否 在 构建 测试 项 目的 时 候 开 局 debug 输 出 。 


‘settingsFile (File) : 执行 集成 测试 所 使 用 的 settings.xml， 默 认为 
本 机 环境 settings.xml。 


‘localRepositoryPath (File) : 执行 集成 测试 所 使 用 的 本 地 仓库 ， 黑 
认 就 是 本 机 环境 仓库 。 
-preBuildHookScript (String) : 构建 测试 项 目 之 前 运行 的 BeanShell 


或 Groovy 脚 本 。 


.postBuildHookScript (String) : 构建 测试 项 目 之 后 运行 的 
BeanShell 或 Groovy 脚 本 。 


要 了 解 更 多 的 配置 点 ， 或 者 簿 看 更 多 的 样 例 。 读 者 可 以 访问 maven- 
invoker-plugin 的 站 点 : http://maven.apache.org/plugins/maven-invoker- 


plugin/。 


177 whee 


Maven 社 区 提供 了 成 百 上 干 的 插件 供用 户 使 用 ， 这 些 插件 能 够 满足 
绝 大 部 分 用 户 的 需求 。 然 而 ， 在 极 少数 的 情况 下 ， 用 户 还 是 需要 编写 
Maven 插 件 来 满足 目 己 非常 特殊 的 需求 。 编 写 Maven 插 件 的 一 般 步 又 包 
括 创 建 一 个 插件 项 目 、 编 号 Mojo、 为 Mojo 提 供 配置 点 、 实 现 Mojo 行 
为 、 处 理 错误 、 记 录 日 志和 测试 插件 等 。 本 章 实现 了 一 个 简单 的 代码 行 
统计 插件 ， 并 逐步 展示 了 上 述 步 怠 。 用 户 在 编写 自己 插件 的 时 候 ， 还 可 
以 参考 本 章 描 述 的 各 种 Mojo 标 注 、Mojo 参 数 、 异 常 类 型 和 日 志 接 口 。 
本 章 最 后 介绍 了 如 何 使 用 maven-invoker-plugin 实 现 插件 的 自动 化 集成 测 
试 。 
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3.5 节 已 经 简单 介绍 了 如 何 使 用 Maven Archetype 快 速生 成 项 目 骨 
架 。 读 者 可 以 将 Archetype 理 解 成 Maven 项 目的 模板 ， 例 如 maven- 
archetype-quickstart 就 是 最 简单 的 Maven 项 目 模板 ， 只 需要 提供 基本 的 元 
素 〈 如 groupId、artifactId 及 version 等 ) ， 它 就 能 生成 项 目的 基本 结构 及 
POM 文 件 。 很 多 著名 的 开源 项 目 〈 如 AppFuse 和 Apache Wicket) 都 提供 
了 Archetype 方 便 用 户 快 速 创建 项 目 。 如 果 你 所 在 组 织 的 项 目 都 遵循 一 些 
通用 的 配置 及 结构 ， 则 也 可 以 为 其 创建 一 个 自己 的 Archetype 并 进行 维 
护 。 使 用 Archetype 不 仅 能 让 用 户 快 速 简 单 地 创建 项 目 ， 还 可 以 鼓励 大 家 
遵循 一 些 项 目 结构 及 配置 约定 。 


18.1 Archetype H RX 
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18.1.1 Maven Archetype Plugin 


Archetype 并 不 是 Maven 的 核心 特性 ， 它 也 是 通过 插件 来 实现 的 ， 这 
一 插件 就 是 maven-archetype- 
plugin (http://maven.apache.org/archetype/maven-archetype-plugin/) 。 尽 
管 它 只 是 一 个 插件 ， 但 由 于 其 使 用 范围 非常 广泛 ， 主 要 的 IDE《〈 如 
Eclipse、NetBeans 和 IDEA) 在 集成 Maven 的 时 候 都 着 重 集成 了 archetype 
特性 ， 以 方便 用 户 快速 地 创建 Maven 项 目 。 


在 本 书 编写 的 时 候 ，maven-archetype-plugin 最 新 的 版 本 是 2.0-alpha- 
5。 需 要 特别 注意 的 是 ， 该 插件 的 1.x 版 本 和 2.x 版 本 差异 很 大 。 在 1.x 版 
本 中 ， 使 用 Archetype 创 建 项 目 使 用 的 目标 是 archetype: create， 但 这 一 
目标 在 2.x 版 本 中 已 经 不 推荐 使 用 了 ， 取 而 代 之 的 是 archetype: 
generate。 它 们 主要 的 差异 在 于 ， 前 者 要 求 用 户 必须 一 次 性 地 从 命令 行 
输入 所 有 的 插件 参数 ， 而 后 者 默认 使 用 交互 的 方式 提示 用 户 选 择 或 输入 
参数 。 不 仅 如 此 ，archetype: generate 也 完全 支持 archetype: create 的 特 
性 ， 因 此 用 户 已 经 完全 没有 必要 去 使 用 旧 的 archetype: create 目 标 了 。 


18.1.2 ”使 用 Archetype 的 一 般 步 又 


3.5 节 推荐 用 户 在 使 用 Archetype 插 件 的 时 候 输 入 完整 的 插件 坐标 ， 
以 防止 Maven 下 载 最 新 的 不 稳定 快照 版 本 。 然 而 这 种 情况 只 是 对 于 
Maven 2 用 户 和 存在， 在 Maven 3 中 ， 如 果 插 件 的 版 本 未 声明 ，Maven 只 会 
目 动 解析 最 新 的 发 布 版 ， 因 此 用 户 不 用 担心 引入 快照 版 本 融 来 的 问题 。 
以 下 是 两 条 命令 的 对 比 : 


‘Maven 3: mvn archetype: generate 


‘Maven 2: mvn org.apache.maven.plugins: maven-archetype-plugin: 


2.0-alpha-5: generate 


输入 上 述 命 令 后 ，Archetype 插 件 会 输出 一 个 Archetype 列 表 供 用 户 
选择 。 例 如 : 


Choose archetype: 
1: internal - > appfuse -basic -jsf {AppFuse archetype for creating a web applica- 


tion with Hibernate, Spring and JSF) 


2: internal — > appfuse -basic -spring (AppFuse archetype for creating a web ap- 
plication with Hibernate, Spring and Spring MVC) 


3: internal - > appfuse - basic -struts (AppFuse archetype for creating a web ap- 
plication with Hibernate, Spring and Struts 2) 

4: internal -= > appfuse -basic -tapestry (AppFuse archetype for creating a web ap- 
plication with Hibernate, Spring and Tapestry 4) 

5: internal 一 > appfuse —core (AppFuse archetype for creating a jar application 
with Hibernate and Spring and XFire) 

6: internal -— > appfuse - modular -jsf (AppFuse archetype for creating a modular 
application with Hibernate, Spring and JSF) 

7: internal -~ > appfuse -modular -spring (AppFuse archetype for creating a modu- 
lar application with Hibernate, Spring and Spring MVC) 

8: internal - > appfuse -modular -struts (AppFuse archetype for creating a modu- 
lar application with Hibernate, Spring and Struts 2) 

9: internal - > appfuse-modular -tapestry (AppFuse archetype for creating a modu- 
lar application with Hibernate, Spring and Tapestry 4) 

10: internal -— > makumba -archetype (Archetype for a simple Makumba application) 

11: internal - > maven -archetype —-j2ee-—simple (A simple J2EE Java application) 

12: internal - > maven -archetype - marmalade -mojo (A Maven plugin development 
project using marmalade) 

13: internal - > maven -archetype -mojo (A Maven Java plugin development project) 

14: internal - > maven-—archetype -portlet (A simple portlet application) 

15: internal — > maven -archetype -profiles () 

16: internal - > maven -archetype -quickstart () 


这 个 列表 来 自 于 名 为 archetype-catalog.xml 的 文件 ，18.3 节 将 对 其 进 
行 深 入 解释 。 现 在 ， 用 户 需 要 选择 自己 想 要 使 用 的 Archetype， 然 后 输入 
其 对 应 的 编号 。 


由 于 Archetype 只 是 一 个 模板 ， 为 了 保持 模板 的 通用 性 ， 它 的 很 多 重 
要 内 容 都 是 可 配置 的 。 因 此 ， 在 用 户 选 择 了 一 个 Archetype 之 后 ， 下 一 步 
就 需要 提供 一 些 基 本 的 参数 。 主 要 有 : 


groupId: 想 要 创建 项 目的 groupId。 
“artifactId: 想 要 创建 项 目的 artifactId。 


.version: 想 要 创建 项 目的 version 。 


‘package: 想 要 创建 项 目的 默认 Java 包 名 。 


上 述 参数 是 Archetype 插 件 内 置 的 ， 也 是 最 常用 和 最 基本 的 。 用 户 在 
上 自己 编写 Archetype 的 时 候 ， 还 可 以 声明 额外 的 配置 参数 。 


根据 Maven 提 示 填 写 完 配置 参数 之 后 ，Archetype 插 件 就 能 够 生成 项 
目的 骨架 了 。 


18.1.3” 批 处 理 方式 使 用 Archetype 


有 时 候 用 户 可 能 不 希望 以 交互 的 方式 使 用 Archetype， 例 如 当 创建 
Maven 项 目的 命令 在 一 段 自动 化 的 Shell 脚 本 中 的 时 候 ， 交 互 的 方式 会 破 
坏 自动 化 。 这 时 用 户 可 以 使 用 mvn 命 令 的 -B 选 项 ， 要 求 maven-archetype- 
plugin 以 批 处 理 的 方式 运行 。 不 过 ， 这 时 用 户 还 必须 显 式 地 声明 要 使 用 
的 Archetype 坐 标 信 息 ， 以 及 要 创建 项 目的 groupId、artifactId、version、 


package 等 信息 。 例 如 : 


$ > mvn archetype:generate -B \ 

—DarchetypeGroupId =org. apache. maven. archetypes \ 

—DarchetypeArtifactId =maven -archetype -quickstart \ 

—DarchetypeVersion=1.0 \ 

一 DgroupId = com. juvenxu.mvnbook \ 

—DartifactId = archetype -test \ 

—Dversion =1.0 -SNAPSHOT \ 

—Dpackage = com. juvenxu. mvnbook 

[INFO] Scanning for projects... 

[INFO] 

a 

[INFO] Building Maven Stub Project (No POM} 1 

To = 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 

[INFO] 

[INFO] > > > maven - archetype ~ plugin:2.0 -alpha -5:generate (default -cli) Be 
standalone -pom > >> 

[INFO] 

[INFO] < < < maven - archetype -plugin:2.0 -alpha -5:generate (default -cli}) @ 
standalone -pom < < < 

[INFO] 

[INFO] ---maven -archetype -plugin:2.0 -alpha -5:generate (default -cli) @ stan- 
dalone -pom 一 一 一 

[INFO] Generating project in Batch mode 

[INFO] Archetype repository missing. Using the one from forg.apache.maven. arche- 
types :maven -archetype —quickstart:1.0] found in catalog remote 
INFO] -一 -一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Using following parameters for creating OldArchetype: maven —archetype - 
quickstart :1.0 
[INFO] -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Parameter: groupld, Value: com, juvenxu. mvnbook 
[INFO] Parameter: packageName, Value: com. juvenxu. mvnbook 
[INFO] Parameter: package, Value: com. juvenxu. mvnbook 
[INFO] Parameter: artifactid, Value: archetype -test 
[INFO] Parameter: basedir, Value: D: \tmp archetype 
[INFO] Parameter: version, Value: 1.0 -SNAPSHOT 
[INFO] ** ** see #e# * ke we ee eee eH k End of debug info from resources from 
generated POM ** #*e# e*e*e# eee ee RR ESR HH RH kH 
[INFO] OldArchetype created in dir: D: \tmp ‘archetype ‘archetype -test 
CC 人 CC 人 CC 人 CC 人 CC 人 CC 人 CC 人 CC 
[INFO] BUILD SUCCESS 
[ROOT 
[INFO] Total time: 2.624s 
[INFO] Finished at: Wed Apr 28 14:34:32 CST 2010 
[INFO] Final Memory: 6M/11M 
[INFO] mmm ee 








该 例 中 的 Archetype 的 坐标 为 org.apache.maven.archetypes: maven- 
archetype-quckstart: 1.0， 而 真正 要 创建 的 项 目 坐标 则 为 
com.juvenxu.mvnbook: archetype-test: 1.0-SNAPSHOT。 


18.1.4 各 用 Archetype 介 绍 


在 编写 本 书 的 时 候 ，Maven 中 央 仓 库 中 已 经 包含 了 249 个 
Archetype 〈 详 见 http://repol.maven.org/maven2/archetype-catalog.xml) 。 
此 外 ， 还 有 大 量 没 有 发 布 到 中 央 仓 库 的 Archetype 分 布 在 其 他 Maven 仓 库 
中 。 任 何人 都 不 可 能 全 部 了 解 它们 ， 因 此 这 里 只 介绍 几 个 比较 常用 的 
Archetype. 





1.maven-archetype-quickstart 


maven-archetype-quickstart HJ fé <x s HH Archetype, ~4{maven- 
archetype-plugingéas HF i ArchetypelIN (ik, EDMEE. TEA 
maven-archetype-quickstart 生 成 的 项 目 十 分 简单 ， 基 本 内 容 如 下 : 


一 个 包含 JUnit 依 赖 声 明 的 pom.xml。 


:src/main/java 主 代码 目录 及 该 目录 下 一 个 名 为 App 的 输出 “Hello 
World! ”的 类 。 


.Src/tesUjava 测 试 代码 目录 及 该 目录 下 一 个 名 为 AppTest 的 JUnit 测 试 
用 例 。 


当 需 要 创建 一 个 全 新 的 Maven 项 目 时 ， 束 可 以 使 用 该 Archetype 生 成 


项 目 后 进行 修改 ， 省 去 了 手工 创建 POM 及 目录 结构 的 麻烦 。 
2.maven-archetype-webapp 


这 是 一 个 最 简单 的 Maven war 项 目 模板 ， 当 需要 快速 创建 一 个 web 
应 用 的 时 候 就 可 以 使 用 它 。 使 用 maven-archetype-webapp 生 成 的 项 目 内 
容 如 下 : 





.一 个 packaging 为 war 且 带 有 JUnit 依 赖 声 明 的 pom.xml。 
.Src/main/webapp/ 目 录 。 
src/main/webapp/index.jsp 文 件 ， 一 个 简单 的 Hello World 页 面 。 


“src/main/webapp/WEB-INF/web.xml 文 件 ， 一 个 基本 为 空 的 Web 应 
用 配置 文件 。 


3.AppFuse Archetype 


AppFuse 是 一 个 集成 了 很 多 开源 工具 的 项 目 ， 它 由 Matt Raible 开 
发 ， 旨 在 帮助 Java 编 程 人 员 快 速 高 效 地 创建 项 目 。AppFuse 本 身 使 用 
Maven 构 建 ， 它 的 核心 其 实 就 是 一 个 项 目的 骨架 ， 是 包含 了 持久 层 、 业 
务 层 及 展现 层 的 一 个 基本 结构 。 在 AppFuse 2.x 中 ， 已 经 集成 了 大 量 流行 
的 开源 工具 ， 如 Spring、Struts 2、JPA、JSF、Tapestry 等 。 





AppFuse 为 用 户 提 供 了 大 量 Archetype， 以 方便 用 户 快速 创建 各 种 类 


型 的 项 目 ， 它 们 都 使 用 同样 的 groupId org.appfuse。 针 对 各 种 展现 层 框架 


分 别 为 : 
-appfuse-*-jsf: 基于 JSF 展 现 层 框架 的 Archetype。 
-appfuse-*-spring: 基于 Spring MVC 展 现 层 框架 的 Archetype。 
-appfuse-*-struts: 基于 Struts 2 展现 层 框架 的 Archetype。 
-appfuse-*-tapestry: 基于 Tapestry 展 现 层 框架 的 Archetype。 


每 一 种 展现 层 框 架 都 有 3 个 Archetype， 分 别 为 light、basic 和 
modular。 其 中 ，light 类 型 的 Archetype 只 包含 最 简单 的 骨架 ;basic 类 型 
的 Archetype 则 包含 了 一 些 用 户 管理 及 安全 方面 的 特性 ; modular 类 型 的 
Archetype 会 生成 多 模块 的 项 目 ， 其 中 的 core 模 块 包含 了 持久 层 及 业务 层 
的 代码 ， 而 Web 模 块 则 是 展现 层 的 代码 。 


更 多 关于 AppFuse Archetype 的 信息 ， 读 者 可 以 访问 其 官方 的 快速 入 
门 手 册 : http://appfuse.org/display/apf/appfuse+quickstart。 


18.2 ”编写 Archetype 


也 许 你 所 在 组 织 的 一 些 项 目 都 使 用 同样 的 框架 和 项 目 结构 ， 为 一 个 
个 项 目 重 复 同 样 的 配置 及 同样 的 目录 结构 显然 是 难以 让 人 接受 的 。 更 好 
的 做 法 是 创建 一 个 属于 自己 的 Archetype， 这 个 Archetype 包 含 了 一 些 通 
用 的 POM 配 置 、 目 录 结 构 ， 甚 至 是 Java 类 及 资源 文件 ， 然 后 在 创建 项 目 
的 时 候 ， 惑 可 以 直接 使 用 该 Archetype， 并 提供 一 些 基 本 参数 ， 如 
groupId、artifactId4、version，maven-archetype-plugin 会 处 理 其 他 原本 需 
要 手工 处 理 的 劳动 。 这 样 不 仅 节 省 了 时 间 ， 也 降低 了 错误 配置 发 生 的 概 








下 面 就 介绍 一 个 创建 Archetype 的 样 例 。 首 先 读 者 需要 了 解 的 是 ， 一 
个 典型 的 Archetype Maven 项 目 主 要 包括 如 下 几 个 部 分 : 


‘pom.xml: Archetype 上 自身 的 POM。 


-src/main/resources/archetype-resources/pom.xml: 基于 该 Archetype 生 


成 的 项 目的 POM 原 型 。 


‘src/main/resources/META-INF/maven/archetype-metadata.xml: 


Archetype 的 描述 符 文 件 。 


src/main/resources/archetype-resources/**: 其 他 需要 包含 在 


Archetype 中 的 内 容 。 


下 面 结合 样 例 对 上 述 内 容 一 一 详细 解释 。 











首先 ， 和 任何 其 他 Maven 项 目 一 样 ，Archetype 项 目 自 身 也 需要 有 一 
个 POM。 这 个 POM 主 要 包含 该 Archetype 的 坐标 信息 ， 这 样 Maven 才 能 
定位 并 使 用 它 。 读 者 还 要 留意 ， 不 要 混 清 Archetype 的 坐标 和 使 用 该 
Archetype 生 成 的 项 目的 坐标 。 需 要 注意 的 是 ， 虽 然 Archetype 可 以 说 是 
一 种 特殊 的 Maven 项 目 ， 但 maven-archetype-plugin 并 没有 要 求 Archetype 
项 目 使 用 特殊 的 打包 类 型 。 因 此 ， 一 般 来 说 ，Archetype 的 打包 类 型 就 是 
默认 值 jar。 代 码 清 单 18-1 展 示 了 一 个 很 简单 的 Archetype 的 POM。 





代码 清单 18-1 ” 样 例 Archetype 的 POM 





<project xmlns = "http://maven.apache.org/POM/4.0.0" 
3. 3 na 


chema 一 instance" 


< /groupId > 
ole < /artifactId > 


fe FRERE Archetype hh Ba WIA SAM. MASE 
来 说 ， 在 编写 Archetype 的 时 候 预 先 定义 好 其 要 包含 的 目录 结构 和 文件 ， 
同时 在 必要 的 地 方 使 用 可 配置 的 属性 声明 替代 硬 编 码 。 例 如 ， 项 目的 坐 
标 信息 一 般 都 是 可 配置 的 。 代 码 清 单 18-2 就 是 一 个 简单 的 POM 原 型 ， 它 
位 于 Archetype 项 目 资源 目录 下 的 archetype-resources/ 子 目录 中 。 


代码 清单 18-2” 样 例 Archetype 所 包含 的 POM 原 型 


< 


project xmlns = "http://maven. apache. org/POM/4.0 
xmins:xsi = "“http://www.w3.org/2001 /XMLSchema - instance" 

xsi:schemaLocation = “http: //maven. apache. org/POM/4.0.0 

http: //maven. apache. org /xsd/maven -4.0.0.xsd"> 

<modelVersion >4.0.0 < /modelVersion > 

<groupid > $ {groupId} < /qroupId > 

<arti 


Qe 


VU 


factId > $ fartifactId} < /artifactId > 
<version > $ {version} < /version> 

<name > $ {artifactId} < /name > 

<url >http://www. juvenxu.com< /url > 


«dependencies > 
< dependency > 
<groupīid >junit < /groupid > 
<artifactId >junit < /artifactId > 
<version >4.8.1</version> 
< scope > test < /scope > 





< /depencency > 
< /dependencies > 


<build> 
<pluginManagement > 
<plugins > 
<plugin> 
< groupId > org. apache. maven. plugins < /grouplid > 
<artifactId >maven -compiler -plugin < /artifactId > 
<configuration > 
< source >1.5 </source> 
<target >1.5 </target > 
</ configuration > 
</plugin > 
<plugin > 
<groupId > org. apache. maven. plugins < /groupld > 
<artifactid >maven -resources -plugin < /artifactiad> 
<configuration > 
<encoding >UTF -8 < /encoding > 
< f/eonfiguration > 
</plugin > 
< /plugins > 
< /pluginManagement > 
< /build> 
</project > 





上 述 代 码 片 段 中 的 groupId、artifactId 和 version 等 信息 并 没有 直接 声 
而 是 使 用 了 属性 声明 。 回 顾 18.1.2 节 ， 使 用 Archetype 生 成 项 目的 时 


用 户 一 般 都 需要 提供 groupId、artifactId、version、package 等 参数 ， 


在 那个 时 候 ， 这 些 属性 声明 就 会 由 那些 参数 值 填充 。 


述 POM 原 型 中 还 包含 了 一 个 JUnit 依 赖 声 明 和 两 个 插件 配置 。 事 
实 上 ， 我 们 可 以 根据 自己 的 实际 需要 在 这 里 提供 任何 合法 的 POM 配 置 ， 
在 使 用 该 Archetype 生 成 项 目的 时 候 ， 这 些 配 置 束 是 现成 的 了 。 











一 个 Archetype 最 核心 的 部 分 是 archetype-metadata.xml 描 述 符 文 件 ， 
它 位 于 Archetype 项 目 资源 目录 的 META-INF/maven/ 子 目录 下 。 它 主要 用 
来 控制 两 件 事情 : 一 是 声明 哪些 目录 及 文件 应 该 包含 在 Archetype 中 ; 二 
是 这 个 Archetype 使 用 哪些 属性 参数 。 代 码 清单 18-3 展 示 了 一 个 Archetype 
描述 符 文 件 。 


代码 清单 18-3” 样 例 Archetype 描 述 符 文件 


<?xml version = "1.0" encoding = "UTF 一 8 "2? > 
<archetype -descriptor name = "sample" > 
<fileSets > 
<fileSet filtered = "true" packaged = "true" > 
<directory >src/main/java < /directory > 
< includes > 
<include > * * / *.java < /include > 
< /includes > 
</fileSet > 
<fileSet filtered = "true" packaged = "true" > 
< directory >src/test/java < /directory > 
< includes > 
<include > * #/#*.java< /include> 
< /includes > 
< /fileSet > 
<fileSet filtered = "true" packaged = "false"> 
<directory >src/main/resources < /directory 
< includes > 
<include > * * / * . properties < /include > 
/includes > 
< /fileSet > 
/fileSets > 
<requiredProperties > 
<requiredProperty key 
<requiredProperty 
<defaultVa 
< /requiredPrope 
s iredProperties > 








>com. juvenxu.mvnbook < /defaultValue > 





< archetype -descriptor > 


该 例 中 的 Archetype 摘 述 符 定义 了 和 名称 为 sample。 它 主要 包含 fileSets 
和 requireProperties 两 个 部 分 。 其 中 ，fileSets 可 以 包含 一 个 或 者 多 个 
fileSet 子 元 素 ， 每 个 fileSet 定 义 一 个 目录 ， 以 及 与 该 目录 相关 的 包含 或 
排除 规则 。 


上 述 代 码 片 段 中 的 第 一 个 fieSet 指 向 的 目录 是 srcmaimrjava， 该 目录 
对 应 于 Archetype 项 目 资源 目录 的 archetype-resources/src/main/java/ 子 目 
录 。 该 fileSet 有 两 个 属性 ，filtered 表 示 是 否 对 该 文件 集合 应 用 属性 蔡 
换 。 例 如 ， 像 ${x 这 样 的 内 容 是 否 蔡 换 为 命令 行 输入 的 x 参 数 的 值 ; 
packaged 表 示 是 个 将 该 目录 下 的 内 容 放 到 生成 项 目的 包 路 径 下 。18.1.2 


节 提 到 使 用 Archetype 必 须 提供 的 参数 之 一 就 是 package， 即 项 目 包 名 。 
如 果 读 者 暂时 无 法 理解 这 两 个 属性 的 作用 ， 不 必 着 急 ， 稍 后 通过 实例 来 


解释 。 


该 fileSet 还 包含 了 includes 子 元 素 ， 并 且 声 明了 一 个 值 为 **/*.java 的 
include 规 则 ， 表 示 包 含 src/main/java/ 中 任意 路 径 下 的 java 文 件 。 这 里 两 
个 星 号 ** 表 示 匹 配 任意 目录 ， 一 个 星 号 * 表 示 匹 配 除 路 径 分 隔 符 外 的 任 
意 0 个 或 者 多 个 字符 。 这 种 匹配 声明 的 方式 在 Maven 的 很 多 插件 中 都 被 
用 到 ， 如 10.5 节 中 的 maven-surefire-plugin。 除 了 includes， 用 户 还 可 以 使 
用 excludes 声 明 要 排除 的 文件 。 配 置 方法 与 includes 类 似 ， 这 里 不 再 更 








为 了 能 够 说 明 问 题 ， 笔 者 在 src/main/resources/archetype- 
resources/src/main/java/ 目 录 下 创建 了 一 些 文件 ， 假 设 使 用 该 Archetype 创 
建 项 目的 时 候 ，package 参 数 的 值 为 com.juvenxu.mvnbook。 表 18-1 表 示 
了 Archetype 中 文件 与 生成 项 目 文件 的 对 应 关系 。 





表 18-1 Archetype 资 源 文件 与 所 生成 项 目 文件 的 对 应 关系 





Archetype 资源 日 录 下 生成 的 项 目 根 目录 下 
Shins src/ main/ java/ 
archetype- resources/ src/ main/ java/ . 
, (package = com. juvenxu. mvnbook ) 
App. java com. juvenxu. mvnbook. App. java 
dao/ Dao. java com. juvenxu. mvnbook. dao. Dao. java 


service/ Service. java com. juvenxu. mvnbook. service. Service. java 


如 果 fileSet 的 packaged 属 性 值 为 tue，directory 的 值 为 X， 那 么 
archetype-resources 下 的 X 目 录 就 会 对 应 地 在 生成 的 项 目 中 被 创建 ， 在 生 
成 项 目的 该 X 目 录 下 还 会 生成 一 个 包 目 录 ， 如 上 例 中 的 
com/juvenxu/mvnbook/， 最 后 Archetype 中 XX 目录 的 子 目 录 及 文件 被 复制 
到 生成 项 目 X 目 录 的 包 目 录 下 。 如 果 packaged 的 属性 值 为 false， 那 么 
Archetype 中 X 目 录 下 的 内 容 会 被 直接 复制 到 生成 项 目的 X 目 录 下 。 一 般 
来 说 ，Java 代 码 都 需要 放 到 包 路 径 下 ， 而 项 目 资源 文件 则 不 需要 。 因 
此 ， 在 代码 清单 18-3 中 ， 第 一 、 第 二 个 对 应 Java 文 件 的 包 eSet 的 packaged 
的 属性 为 tue， 而 第 三 个 对 应 资源 文件 的 fleSet 的 packaged 属 性 为 false。 

















还 有 一 点 需要 解释 的 是 fileSet 的 filtered 属 性 ， 它 表示 使 用 参数 值 蔡 
换 属 性 声明 ， 这 是 个 非常 有 用 的 特性 。 例 如 ， 表 18-1 中 涉及 的 几 个 Java 
类 都 需要 有 package 声 明 ， 而 且 其 值 是 在 项 目 生 成 的 时 候 确 定 的 。 这 时 
就 可 以 在 Java 代 码 中 使 用 属性 声明 ， 如 App.java 的 内 容 应 该 如 代码 清单 
18-4 所 未 。 





代码 清单 18-4 ”Archetype 中 的 App.java 





public static void main( String[] args ) 


System. out.printin( "Hello World!" ); 


在 使 用 包 名 com.juvenxu.mvnbook 创 建 项 目 后 ， 上 述 代 码 中 的 第 一 


行 会 变 成 package com.juvenxu.mvnbook; 


类 似 地 ，Dao.java 和 Service.java 的 包 声 明 应 该 如 代码 清单 18-5 所 


代码 清单 18-5 ”Archetype 中 的 Dao.java 和 Service.java 





package $ {package}. dao; 


对 应 地 ， 项 目 生成 后 Dao.java 的 第 一 行 会 成 为 “package 
com.juvenxu.mvnbook.dao; ”， 而 Service.java 的 第 一 行 会 成 为 "package 
com.juvenxu.mvnbook.service; ”。 使 用 这 样 的 技巧 ， 就 可 以 在 Archetype 
中 创建 多 层次 的 Java 代 码 。 


默认 情况 下 ，maven-archetype-plugin 要 求 用 户 在 使 用 Archetype 生 成 
项 目的 时 候 必须 提供 4 个 参数 : groupId、artifactId、version 和 package。 
除 此 之 外 ， 用 户 在 编写 Archetype 的 时 候 可 以 要 求 额 外 的 参数 。 例 如 ， 代 
码 清 单 18-3 就 使 用 了 requireProperties 配 置 要 求 额 外 的 port 参 数 ， 这 样 ， 


Archetype 中 所 有 开局 filtered 的 文件 中 就 可 以 使 用 $ {port} 属 性 声明 ， 然 
后 在 项 目 生成 的 时 候 用 命令 行 输入 的 值 填 充 。 


此 外 ， 在 编写 Archetype 的 时 候 还 可 以 为 预 置 的 4 个 参数 提供 默认 
值 。 例 如 ， 代 码 清单 18-3 中 就 为 groupId 参 数 提供 了 默认 值 
com.juvenxu.mvnbook。 在 组 织 内 部 ， 可 能 很 多 项 目的 groupId 是 确定 
的 ， 这 时 就 可 以 为 Archetype 提 供 默认 的 groupId。 





Archetype 编 写 完 成 之 后 ， 使 用 mvn clean install 将 其 安装 到 本 地 仓 
库 。 接 着 用 户 就 可 以 通过 指定 该 Archetype 的 坐标 用 它 生成 项 目 了 : 


5 > mvn archetype:generate \ 
—DarchetypeGroupId =com. juvenxu.mvnbook.archetypes \ 
—DarchetypeArtifactId =mvnbook -archetype -sample \ 
—DarchetypeVersion =1.0 - SNAPSHOT 
[INFO] Scanning for projects... 

INFO] 


DELEN so 





[INFO] Building Maven Stub Project (No POM) 1 
NROJ See a E yA EEEE 
INFO 
INFO] > > > maven-archetype-plugin:2.0-alpha-5:generate (default-cli)@ standa 
lone-pom > > > 
INFO] 
INFO] < < < maven-archetype-plugin:2.0-alpha-5 :generate (default-cli) @ standa 


[INFO] 

[INFO] —--maven-archetype-plugin:2.0-alpha-5:generate (default-cli) @ standa- 
lone-pom —-— 

[INFO] Generating project in Interactive mode 

[WARNING] No archetype repository found. Falling back to central repository (ht- 
tp://repol.maven. org/mavenz2 ). 

[WARNING] Use -DarchetypeRepository = <your repository > if archetype's reposito- 
ry is elsewhere. 

[INFO] snapshot com. juvenxu.mvnbook. archetypes :mvnbook-archetype-sample:1.0- 
SNAPSHOT: checking for updates from mvnbook-archetype-sample-repo 

[INFO] Using property: groupId = com. juvenxu.mvnbook 

Define value for property 'artifactId': : test 

Define value for property 'version': 1,0 - SNAPSHOT: : 

[INFO] Using property: package = com. juvenxu.mvnbook 

Define value for property'port': : 8080 

Confirm properties configuration: 

groupId: com. juvenxu.mvnbook 

artifactId: test 

version: 1,0 — SNAPSHOT 

package: com. juvenxu. mvnbook 

port: 8080 

Ye oy 

[INFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 

[INFO] BUILD SUCCESS 

[INFO] -一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 

[INFO] Total time: 27.365s 

[INFO] Finished at: Sun May 02 01:13:10 CST 2010 

[INFO] Final Memory: 5M/10M 


CUPO] 一 





该 例 使 用 了 交互 式 的 方式 生成 项 目 ， 由 于 该 Archetype 为 groupId 定 
义 了 默认 值 ， 用 户 就 不 再 需要 输入 groupId 的 值 了 。 此 外 ， 用 户 还 不 得 不 
输入 该 Archetype 额 外 定义 的 port 参 数 的 值 。 


18.3 Archetype Catalog 


18.2 节 中 我 们 自 定 义 了 一 个 Archetype， 然 后 可 以 通过 指定 该 
Archetype 的 坐标 在 命令 行 用 它 创建 项 目 原型 。 但 是 ，18.1.2 节 告诉 我 
们 ， 通 常 使 用 Archetype 不 需要 精确 地 指定 Archetype 的 坐标 ，maven- 
archetype-plugin 会 提供 一 个 Archetype 列 表 供 我 们 选择 。 那 么 ， 能 和 否 把 自 
己 创 建 的 Archetype 加 入 到 这 个 列表 中 呢 ? 答案 是 肯定 的 。 下 面 就 介绍 相 
关 的 做 法 及 相关 原理 。 


18.3.1 什么 是 Archetype Catalog 


当 用 户 以 不 指定 Archetype 坐 标的 方式 使 用 maven-archetype-plugin 的 
时 候 ， 会 得 到 一 个 Archetype 列 表 供 选择 ， 这 个 列表 的 信息 来 源 于 一 个 名 
为 archetype-catalog.xml 的 文件 。 例 如 ， 代 码 清 单 18-6 是 一 个 包含 了 两 个 





Archetype 信 息 的 archetype-catalog.xml 文 件 。 


代码 清单 18-6 archetype-catalog.xml 


0" encoding = "UTF 一 8"?> 


<?xml version = "1.0 
<archetype -catalog 
xSi:schemaLocation = "http://maven. apache. org/plugins/ maven — archetype - plu- 
ginzarchatyp >e —catalog/1.0.0 
http://maven.apache.org/xsd/archetype —catalog—-1.0.0.xsd" 
‘plugins /maven -arc + mene plugin/arche- 


xmins = "http://maven. apache. org 
type —catalog/1.0.0" 
xmins :xsi = "http://www. w3.org/2001 /XMLSchema — instance" > 
<archetypes > 
<archetype > 
gr oupIQ >com. juvenxu. mvr eee < /grou DId > 
-mvnbook -archetype - sample < /artifactId > 


<artifactId > 
rersion 


<version >1.0 -SNAPSHOT < /v 
<de x een pe >sample < /description: 
< /archetype > 
<ar pease a 
< groupId >org. apache. maven. archetypes < /groupId > 
cartifactId >maven -archetype -quickstart < /artifactId > 
< version >1.0 < /version > 
< -doscript ion enoliclbnnl </description> 


< /archetype > 


Gf hetypes > 
</archetype -catalog > 


Es 


上 述 archetype-catalog.xml 包 含 的 两 个 Archetype 读 者 应 该 已 经 熟悉 


第 一 个 Archetype 的 坐标 是 com.juvenxu.mvnbook.archetypes: 


Í, 
1.0-SNAPSHOT， 也 就 是 上 一 节 自 定义 的 


mvnbook-archetype-sample: 





Ae — 


Archetype; 第 二 个 则 是 maven-archetype-plugin 默 认 使 用 的 Quickstart 
Archetype。 这 个 XML 非 营 简单 ， 它 主要 包含 了 各 个 Archetype 的 坐标 。 
这 样 ， 当 用 户 选择 使 用 某 个 Archetype 的 时 候 ，Maven 就 能 够 立刻 定位 到 
Archetype 构 件 。 


18.3.2 Archetype Catalog 的 来 源 


archetype-catalog.xml 能 够 提供 Archetype 的 信息 ， 那 么 maven- 
archetype-plugin 可 以 从 哪些 位 置 读 取 archetype-catalog.xml 文 件 呢 ? 下 面 
是 =A j K : 


vy 


‘internal: 这 是 maven-archetype-plugin 内 置 的 Archetype Catalog, 4&3, 


含 了 约 58 个 Archetype 信 息 。 


‘local: 指向 用 户 本 地 的 Archetype Catalog， 其 位 置 为 
~/.m2/archetype-catalog.xml。 需 要 注意 的 是 ， 该 文件 默认 是 不 存在 的 。 


‘remote: 指 问 了 Maven 中 央 仓 库 的 Archetype Catalog， 其 确切 的 地 
址 为 http://repol.maven.org/maven2/archetype-Catalog.xml。 在 本 书 编写 的 
时 候 ， 该 Catalog 包 含 了 约 249 个 Archetype 信 息 。 


file: /…: 用 户 可 以 指定 本 机 任何 位 置 的 archetype-catalog.xml 文 
fFe 


‘hetp://...2 用 户 可 以 使 用 HTTP 协 议 指定 远程 的 archetype-catalog.xml 
MF 


当 用 户 运 行 mvn archetype: generate 命 令 的 时 候 ， 可 以 使 用 


archetypeCatalog 参 数 指定 插件 使 用 的 Catalog。 例 如 : 


$> mvn archetype: generate -DarchetypeCatalog = file:// /tmp/archetype-cata- 
log. xml 


述 命令 指定 Archetype 插 件 使 用 系统 /mp 目录 下 的 archetype- 
catalog.xml 文 件 。 当 然 ， 用 户 不 需要 每 次 运行 Archetype 目 标的 时 候 都 去 
指定 Catalog。 在 maven-archetype-plugin 2.0-beta-4 之 前 的 版 本 中 ， 
archetypeCatalog 的 默认 值 为 “internal，local”， 即 默认 使 用 插件 内 置 加 上 
用 户 本 机 的 Catalog 信 息 ， 而 从 maven-archetype-plugin 2.0-beta-5 开 始 ， 

一 默认 值 变 成 了 “remote，local”， 即 默认 使 用 中 央 仓 库 加 上 用 户 本 机 
的 Catalog 人 信息。 用户 也 可 以 使 用 逗号 分 隔 多 个 Catalog 来 源 。 例 如 ; 











$> mvn archetype: generate -DarchetypeCatalog = file: // /tmp/archetype - cata- 
log. xml,local 


该 命令 指定 Archetype 从 两 个 位 置 读 取 Catalog 信 息 。 


archetype: generate 的 输出 也 会 告诉 用 户 每 一 条 Archetype 信 息 的 来 
Vi o 例 如 : 


1: local - > mvnbook -archetype - sample (sample) 


2: local - > maven -archetype -mojo (plugin) 
3: local - > maven-archetype -quickstart (quickstart) 


å: local - > maven -archetype -webapp (webapp) 

5: internal -— > appfuse-basic- jsf (AppFuse archetype... 

6: internal — > appfuse-basic-spring (AppFuse archetype... 
internal - > appfuse -basic -struts (AppFuse archetype... 
c—tapestry (AppFuse archetype... 





8: internal -— > appfuse—b 
9: internal -— > appfuse -core (AppFuse archetype... 


上 述 输出 片段 告诉 用 户 ，archetype 1-4 来 源 于 本 机 的 
~</.m2/archetype-catalog.xml 文 件 ， 而 archetype 5-9 来 源 于 Archetype 插 件 内 
置 的 archetype-catalog.xml 文 件 。 


18.3.3 ”生成 本 地 仓库 的 Archetype Catalog 


maven-archetype-plugin 提 供 了 一 个 名 为 crawl 的 目标 ， 用 户 可 以 用 它 
来 遍历 本 地 Maven 仓 库 的 内 容 并 自动 生成 archetype-catalog.xml 文 件 。 例 
如 : 


D: \tmp >mvn archetype:crawl 
[INFO] Scanning for projects... 


[INFO] 

INEO] Canana AEE ES EE a 
[INFO] Building Maven Stub Project (No POM) 1 

[ENB] errn E E ES 
[INFO] 


[INFO] —--maven -archetype -plugin:2.0 -alpha -5:crawl (default -cli) @ standa- 
lone -pom ——— 

repository D: \java \repository 

catalogFile null 

[INFO] Scanning D: java \repository \ant \ant 1.5.1 \ant -1.5.1 -sources. jar 

[INFO] Scanning D: \java \repository \ant ‘ant 11.5.1 \ant -1.5.1.jar 

[INFO] Scanning D: \java \repository nt \ant 11.6 \ant -1.6.jar 

[INFO] Scanning D: \java \repository nt \ant \L.6.5 \ant -1.6.5.jar 


[INFO] Scanning D: \java \repository \xpp3 \xpp3_min \1.1.4c \xpp3_min -1.1.4c 一 
sources. jar 


[INFO] Scanning D: \java \repository \xpp3 \xpp3_min .1.4c \xpp3_min -1.1.4c. jar 
PENG] ieee ee ee er er ene is tes 
[INFO] BUILD SUCCESS 

MT a a a 
[INFO] Total time: 19.355s 

[INFO] Finished at: Sun May 02 15 :43 :37 CST 2010 

[INFO] Final Memory: 3M/8M 


如 果 不 提 供 任 何 参 数 ，crawl 目 标 会 般 历 用 户 settings.xml 定 义 的 
localRepository， 并 且 在 该 仓库 的 根 目录 下 生成 archetype-catalog.xml 文 
件 。 用 户 可 以 使 用 参数 repository 指 定 要 授 历 的 Maven 仓 库 ， 使 用 参数 
catalog 指 定 要 更 新 的 catalog 文 件 。 例 如 : 


D: \tmp >mvn archetype:crawl -Drepository =-D:/java/repository \ 
Deatalog =C: /archetype — catalog. xml 


将 和 目 定义 的 Archetype 安 装 到 本 地 仓库 后 ， 使 用 Archetype: crawl 基 
于 该 仓库 生成 的 Catalog 就 会 包含 该 Archetype 的 信息 ， 接 着 用 户 就 可 以 
在 创建 项 目的 时 候 指 定 使 用 该 Catalog。 





18.3.4 ”使 用 nexus-archetype-plugin 


Nexus 团 队 提供 了 一 个 名 为 nexus-archetype-plugin 的 插件 ， 该 插件 能 
够 基于 Nexus 仓 库 索 引 实时 地 生成 archetype-catalog.xml 文 件 。 由 于 
Catalog 内 容 是 基于 仓库 索引 生成 而 不 是 逐个 裔 历 仓 库 文件 ， 因 此 生成 的 
速度 非常 快 。 只 要 用 户 安 装 了 该 插件 ， 每 个 Nexus 仓 库 都 会 随时 提供 一 
个 与 索引 内 容 一 致 的 Catalog。 











用 户 可 以 从 以 下 地 址 下 载 最 新 的 nexus-archetype- 
plugin: http://repository.sonatype.org/content/groups/forge/org/sonatype/nex' 


archetype-plugin/. 


下 一 步 是 将 nexus-archetype-plugin 插 件 的 bundle.zip 包 解压 到 Nexus 工 
作 目 录 sonatype-work/nexus/ 下 的 plugin-repository/ 子 目录 中 ， 然 后 重启 
Nexus, UFI ZREN J o 


现在 ， 当 用 户 浏 览 Nexus 仓 库 内 容 的 时 候 ， 就 能 够 在 仓库 的 根 目 录 
下 看 到 archetype-catalog.xml 文 件 ， 右 击 选 择 “Download” 后 就 能 下 载 该 文 
件 ， 如 图 18-1 所 示 。 


Browse Storage Browse Index 


* Refresh Path Lookup: 


3 Jboss Releases 
D L] index 
S CJ meta 
日 javax 
J (=) enterprise 
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由 | sr299 
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S|) weld 
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图 18-1 用 nexus-archetype-plugin 生 成 Archetype Catalog 


i84 aha 


本 章 详 细 曾 述 了 最 为 有 用 的 Maven 插 件 之 一 : Maven Archetype 
Plugin。 读 者 可 以 选择 以 交互 式 或 者 批 处 理 的 方式 使 用 该 插件 生成 项 目 


骨架 。 另 外 ， 还 介绍 了 一 些 钊 用 的 Archetype。 


本 章 的 重点 是 教授 读者 创建 自己 的 Archetype， 这 主要 包括 理解 
Archetype 项 目的 结构 、 如 何 通过 属性 过 滤 为 Archetype 提 供 灵活 性 ， 以 
及 Archetype Package 参 数 的 作用 。Archetype Plugin 通 过 读 取 Archetype- 
catalog.xml 文 件 内 容 来 提供 可 用 的 Archetype 列 表 人 信息， 这样 的 Catalog 可 
以 从 各 个 地 方 获得 ， 如 插件 内 置 、 本 机 机 器 、 中 央 仓 库 以 及 自 定 义 的 
file: /或 http:/ 路 径 。 本 章 最 后 介绍 了 如 何 使 用 archetype: crawl 和 nexus- 


archetype-plugin 生 成 仓库 的 archetype-catalog.xml 内 容 。 


附录 A POM 元 素 参 考 


元 素 名 称 
< project > 
< parent > 
< modules > 
< groupld > 
<artifactld > 
< version > 
< packaging > 
< name > 
< description > 
< organization > 
< licenses > < license > 
< mailingLists > </ mailingList > 
< developers > </ developer > 
< contributors > < contributor > 
< issue Management > 
< ciManagement > 
< SCm > 
< prerequisites > < maven > 
< build > < sourceDirectory > 
< build > < seriptSourceDirectory > 
< build > <testSourceDirectory > 
< build > < outputDirectory > 
< build > < testOutputDirectory > 
< build > < resources > < resource > 
< build > < testResources > < testResource > 
< build > < finalName > 


< build > < directory > 


简 A 
POM 的 XML 根 元 素 
声明 继承 
声明 聚合 
坐标 元 素 之 一 
坐标 元 素 之 一 
坐标 元 素 之 一 
坐标 元 素 之 一 ， 默 认 值 jar 
名 称 
ji 
所 属 组 织 
许可 证 
邮件 列表 
开发 者 
贡献 者 
问题 追踪 系统 
持续 集成 系统 
版 本 控制 系统 


要 求 Maven 最 低 版 本 ， 默 认 值 2.0 


主 源码 目录 

We ATA Fat 
测试 源码 目录 

主 源码 输出 目录 
测试 源码 输出 目录 
主 资源 目录 
测试 资源 目录 
输出 主 构 件 的 名 称 
输出 目录 


8.5、14.3 
8.5. 14.3 


元 素 名 称 
< build > < filters > < filter > 
< build > < extensions > < extension > 
< build > < pluginManagement > 
< build > < plugins > < plugin > 
< profiles > < profile > 
< distributionManagement > < repository > 


< distribution Management > 
< snapshotRepository > 


< distribution Management > < site > 

< repositories > < repository > 

< pluginRepositories > < pluginRepository > 
< dependencies > < dependency > 

< dependencyManagement > 

< properties > 


<reporting > < plugins > 


简 fi 
通过 properties 文件 定义 资源 过 滤 属 性 
扩展 Maven 的 核心 
插件 管理 
插件 
POM Profile 
发 布 版 本 部 署 仓库 


快照 版 本 部 署 仓 库 


站 点 部 署 
仓库 

插件 仓库 
依赖 
依赖 管理 
Maven 属性 
报告 插件 


( 续 ) 
参考 章节 


15.7 
8.3.3 
RS 
14. 4 
6.4.2, 9.6.1 


6.4.2. 9.6.1 


15. 7 
5.4, 9.5 
T8195 

5.4 

8.3.3 

14. 1 

15.3 


附录 B Settings 元 素 参考 


元 案 名 称 
< settings > 
< localRepository > 
< interactive Mode > 
< offline > 
< pluginGroups > < pluginGroup > 
< servers > < server > 
< mirrors > < mirror > 
< proxies > < proxy > 
< profiles > < profile > 


< activeProfiles > < activeProfile > 


fi 介 
settings. xml SASHA 7c 
本 地 仓库 
Maven 是 否 与 用 户 交互 ， 默 认 值 true 
RERI, BRIA fE false 
插件 组 
于 载 与 部 署 仓 库 的 认证 信息 
仓库 镜像 
代理 
Settings Profile 
激活 Profile 


参考 章节 


6.3.1 


7.8.4 
$4: 2615 Te 
6.7 
2.4 
14. 4 
14.4.2 


插件 名 称 
maven- clean- plugin 
maven- compiler- plugin 
maven- deploy- plugin 
maven- install- plugin 
maven- resources- plugin 
mayen- site- plugin 
maven- surefire- plugin 
maven- jar- plugin 
maven- war- plugin 
maven- shade- plugin 
maven- changelog- plugin 
maven- checkstyle- plugin 
maven- javadoc- plugin 
maven- jxr- plugin 
maven- pmd- plugin 
maven- project- info- reports- plu- 
gin 
maven- surefire- report- plugin 
maven- antrun- plugin 
maven- archetype- plugin 
maven- assembly- plugin 
maven- dependency- plugin 
maven- enforcer- plugin 
maven- pgp- plugin 
mayen- help- plugin 
maven- invoker- plugin 
maven- release- plugin 


maven- scm- plugin 


附录 C 


用 途 
清理 项 目 
编 详 项 目 
HATH 
安装 项 目 
处 理 资源 文件 
生成 站 点 
热 行 测试 
构建 JAR 项 目 
构建 WAR 项 目 
构建 包含 依赖 的 JAR 包 
生成 版 本 控制 变更 报告 
生成 CheckStyle 报告 
HEIR JavaDoc 文档 
生成 源码 交叉 引用 文档 
生成 PMD 报告 
生成 项 目 信息 报告 
生成 单元 测试 报告 
调用 Ant 任务 
基于 Archetype 生成 项 目 骨 架 
构建 自 定义 格式 的 分 发 包 
依赖 分 析 及 控制 
定义 规则 并 强制 要 求 项 目 遵 守 
为 项 目 构件 生成 PGP 签名 
获取 项 目 及 Maven 环境 的 信息 
自动 运行 Maven 项 目 构 建 并 验证 
自动 化 项 目 版 本 发 布 
集成 版 本 控制 系统 


利用 插件 列表 


来 源 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 


参考 章节 
7.2 
7.2 
7.2 
12 
7.2, 14.3 
12. 38 
7,2, 10 
7.2 
7.2, 12.1 
3.4 


5.953 


13. 6.2 
7.6.2, 14.4.2, 16.7.2 
17.6 
13431369 


Hitt EK 用 途 
maven- source- plugin 牛 成 源码 包 
maven- eclipse- plugin 生成 Eclipse 项 目 环境 配置 
build- helper- maven- plugin 包含 各 种 支持 构建 生命 周期 的 目标 
exec- maven- plugin 运行 系统 程序 或 者 Java 程序 
jboss- maven- plugin 启动 、 停 赴 Jhboss， 部 署 项 目 
properties- maven- plugin 从 properties 文件 读 写 Maven 属性 
sql- maven- plugin 运行 SQL 脚本 
tomeat- maven- plugin Ha, Bik Tomcat, REA H 
versions- maven- plugin 自动 化 批 基 更 新 POM 版 本 
P ease 启动 / 停止 / ACT 2K Web AR 8 wh 

eh Web A 

jetty- maven- plugin 集成 Jetty 容器 ， 实 现 快速 开发 测试 
maven- gae- plugin 集成 Google App Engine 
maven- license- plugin 自动 化 添加 许可 证 证 明 至 源码 文件 
maven- android- plugin 构建 Android 项 日 


说 明 : 


来自 Apache 的 完整 插件 列表 


在 : http://maven.apache.org/plugins/index.html. 


来自 Codehaus 的 完整 插件 列表 


在 : http://mojo.codehaus.org/plugins.html。 


:来 自 Googlecode 的 插件 列表 在 : 


http://code.google.com/hosting/search? 


Apache 
Apache 
Codehaus 
Codehaus 
Codehaus 
Codehaus 
Codehaus 
Codehaus 


Codehaus 
Cargo 


Eclipse 
Googlecode 
Googlecode 
Googlecode 


( 2) 
参考 章节 


12.5 


12.4 


q=maven+plugin+label%3Amaven&projectsearch=Search+Projects. 


